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はじめに 



lit の 中には どうやら 2 種類の 人 問が 存在す るよう です 0 

ある 人々 はとに かく II 的 地を li 指し、 途中の 迫 筋には あまり こだわりません。 終わりよ 
ければ すべてよ し 。ロール プレイン グ ゲームで 遊ぶ とき、 洞 功の 宅 物は いくつ も 取り 忘れ 
る けれど、 出 丨 I の 光を U るのは 誰 よりも ¥. いという タイプです。 

ところが その •かで、 丨 AIDH を 確かめながら 一歩一歩 進む のが •きな 人々 もい ます。 この 
タイプの 人たち は 「なんだかよ くわかん ない けど、 できち ゃった 一！」 という 場当たり 的な 
姑 米を 嫌います。 ですから 洞 功に 人ったら、 すべての 経路を しらみつぶしに 踏破し なくて 
は ノ ス がすみ ません。 そのせ いで K に リ丨っ かかったり もす る わけです が… 

どちらが a い惡 いの 問題ではありません 〇 r 人 問には （一人の 人 問の 心の中に だって） そ 
ういう 2 つの 竹:丨( リが浞 心; している もの だ。」 と、 竹さん にも 思い あたる ところが おありで 
しよ ラ？ 



さて ここで、 Windows プログラミングの 丨丨 t 界 へと II を じて みます。 ごむ: じの ように、 
今のところ Windows プログラマには、 2 つの メジ ヤーな プログラミング 手段が 提供され て 
います。 つまり Visual Basic と Visual C ++ の 2 つです 0 

Visi 丨 al Basic と Visual C + + は、 それぞれ プログラミング 丨丨 •語と して W なる 特徴を 持ち、 
それぞれに ふさわしい ⑴途 があります。 といっても、 一竹 前によ くい われて いた 「アマ チュ 
ア の BASIC、 ブロ 川の CJ などと いう 構図とは ちょっと ばかり 違います。 そう、 突は 前 
述の人 問の 行勋 様式の 迫い という ものが、 ここに 深く 閲 わって くるので す。 

Visual Basic は、 何は ともあれ 結果を 早く 得たい、 要するに 「ブロ グラムは 正しく 動けば 
よいの だ」 （これ も、 •/: 派な 1 つの 沾識 です） という* 場の ブロ グラマに お勧めしたい ツール 
です。 Visual Basic は あなたの 鉍 終 H 標に 向けて、 まっすぐな 道を 引いて くれる でしょう。 

それに 対して Visual C+ + による プログラミングは、 Windows の ダン ジョンを 自力で 
ガンガン 進む ような ものです。 なるほど、 先へ 進む には 多少の パワーは 必要です 。袋小路 
に 突き: 当たる こと だってあります。 でも その U 返りと して、 f 丨 分の 好きな 場所に どこに で 
も记を 踏み いれる ことができます。 そして、 Windows に 1阳 する 知識と いう 「宝物」 が 山 ほ 
ど 手に 人り ます。 

繰り返し ますが、 どちらが エ ライと いうので もありません 〇 VisualBasic による スマ 一 
トな プログラミングと、 VisualC+ + による パワー プログラミング、 この 丨时 方を こなせる 
ならば、 それに 優る ものはないでしょう。 ただし、， 荇らの 体験に 照らして みて、 こうい 
うことは いえる と 思います 〇 VisualBasic の丨丨 t 界しか 知らない ブロ グラマは、 Windows ブ 
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ログ ラミングの 本当の おもしろさを まだ 知らない！ これは 絶対に 損です ぜ 、呰 さん。 



さて 「VisualC+ + プログラミングは ダン ジョン だ」 なんて 文字を 見て、 宵さん が あまり 
お ビビり にならない うちに、 ひとこと 付け加えて おきましょう 。安心して ください。 Visual 
C+ + は、 これ 自体が Windows プログラミングの 強力な 助っ人な のです。 

かつて、 C 言語を 使った Windows プログラミングは、 確かに 非常に 手間の かかる もの 
でした。 しかし Visual C+ + を 使えば、 面倒な 作業は 付 城の ツールが サボー 卜して くれ ま 
すし、 定型 処理 部分の （ほぼ） 自動的な コーディング さえして くれる ので、 ブロ グラマは ポ 
イン 卜と なる 部分 だけに 注意を 集中す る ことができます 。また Windows のために 設計 さ 
れた ライブラリの おかげで、 GUI を 利用した 独特の スタイルの ブロ グラムが、 簡単に、 か 
っ 簡潔に 記述で きます。 

本 拽 が 目的と する のは、 Visual C+ + に 用意され た これらの ツール や ライブラリの 活用 
方法を 体験して もらい、 そこから 生まれる 知的な 満足感の- •端を 味わって もらう ことです。 
決して Windows プログラミングの すべてを 網羅し ようとは していません。 

なんだかんだ いっても、 Windows の 独特な プログラミング スタイル、 膨大な ライブラリ 
など、 Visual C+ + を 志す ブロ グラマの 前には 高い 壁が あります。 何も 手掛かり のない 状 
態では、 どこから 手を つけて いい もの か 見当が つかない こと も 多いで しょう。 まだ 右 も 左 
も わからない、 そんな 方々 のために 、本件は とりあえず 「前を 向く 方法」 を お伝えし ようと 
思います 。まずは 足元を 间 めて、 膨大な 情報の 中から 重要な ものと そうでな いものを 見 分 
ける 力を 莽え ば、 あとは 独力で 新しい プログラミングの 世界を 進んで いくこと がで きる は 
ずです。 本 梅が その 確実な 第一歩への 助けに なれば 幸いです。 



Visual C+ + 1.0 に 合わせて 出版され た 「Visual C+ + プログラミング 入門」 です が、 
Visual C+ + の バージ ヨン アップと 同期して 3 回の 改訂を 経る ことにな りました。 Visual 
C ++ 6.0 では 主に Internet Explorer 4.0 で 追加され た コント 口一ルの サボ一卜が 行われ、 
また 引き続き 大幅な 統合 環境の 改善が 行われて います。 本 杏では 第 4 部に おいて、 Internet 
Explorer 4.0 とともに 利用で きる ようになった HTML 表示 機能を 使って、 簡単な WWW 
ブラウザを 作成して います。 また Appendix における 言語 解説を 拡張し、 要望の 多かった 
C++ 言語での ポインタの 扱い方の 解説を 加えました。 

本書を 執筆す るに あたって、 たくさんの 方々 にお 世話になりました。 とくに いくつもの 
有益な 助言を くださった 遠 藤 孝 信 氏、 松 崎武志 氏、 西 村克信 氏、 鈴 木 博 和 氏、 田畑 康彦 氏、 
そして 編集 担当の 川 崎晋ニ 氏に 感謝いた します。 



筆者 一同 
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本書の 構成 



本軎 は、 Microsoft Visual C+ + Development System Version 6.0( 以下 Visual C+ + ) 
を 利用した Windows アプリケーションの 作成 方法を 詳しく 解説した Windows ブロ グラ 
ミン グの 入門 書です。 

Visual C ++ は、 Windows が 提供す る グラフィカル ユーザー インターフェイスを 利用し 
て 効率的に プログラムを 開発で きる、 非常に 優れた ブロ グラム 開発 環境です 。本 抨 は、 C 
ブロ グラマを 対象に、 さまざまな ツールの 利用 法、 Windows プログラミングの 基礎知識、 
ユーザーとの 対話、 ファイル 人出 力な ど、 Windows 上で 動作す る ブロ グラムを 作成す るの 
に 欠かせない 知識に ついて 詳しく 解説した ものです。 

•対象と する 読者 

本 押では、 構造体、 変数、 データ M などに ついては 基本的に 既知の ものと して、 本文で 
はとく に 説明を していません。 したがって、 本 丹 の 内容を 十分に 理解す るには C 言語に 閲 
する 知識が 必要です 〇 C++ 言語に 閲 しては、 本文 中の コラム や Appendix である 程度の 
説明は 行います が、 それ 以上に C+ + 言語に ついて 知りたい という 場合には Visual C+ + 
に 付 城の チュートリアル、 市販の 参考 與 などを 参照して ください 0 
本 宵 を 読み進めて いくのに、 C++ 言語に 関する 知識、 Windows プログラミングの 経験 
などは とくに 必要ありません が、 これらの 知識 や 経験が あれば 本卉の 内容を 理解す るのに 
大きな 助けと なること でしよう 0 

•本文の 構成 

本 咨は全 4 部で 構成され ており、 その 内容は 以下の ようになって います 0 



第 1 部 Visual C++ に 触って みよう 

第 1 部では、 VisualC+ + が 提供す る ブロ グラム 開発 環境を はじめと して、 VisualC+ + 
を 利用した プログラミングの 流れ、 作成した ブロ グラムの 構造、 ブロ グラムを 起動した あ 
との 実行の 流れな ど、 Visual C+ + プログラミングに 必要な 基礎知識 について 説明を して 
います 。また、 C++ 言語に 関する 基礎知識、 VisualC+ + と Windows プログラミングと 
の 関係な どに ついても 第 1 部で 簡単に 説明を 行います。 ここから、 VisualC+ + ブロ グラ 
ミン グの 世界が 広がって いきます 0 




第 2 部 Visual C++ プログラミングの 基本を 押さえよう 

第 2 部では、 いくつかの サンプル ブロ グラムを 通して、 GDI 、 メニュー、 ダイアログ 
ホッ クス、 マウス キーボード 人ノ J といった Windows の ユーザー イン 夕一 フェイスを 介 
して ユーザーと 対詁 をす る 力 •法に ついて 説明を します。 冏 時に Visual C + + が 提供す る 
AppWizard、 リソース エデ イタ、 ClassWizard などの ツールの 炎 際 的な 利用 力 •法に ついて 
も说 明し ます 。また、 ブロ グラム 作成 時に 欠かす ことので きない 作 菜 —— デバッグ —— に 
ついても 解説を します。 これらの 知識は VisualC+ + プログラミングを 進めて いく 上で 屯 
要な 接 礎 体力と なる はずです。 



第 3 部 MFC を 使って みよう 

第 3 部では、 テキス 卜 エディタ + ドロー ツールを 兼ね備えた ブロ グラムを 作成しながら、 
MFC を 使 ⑴ して 本格的な プログラムを 作成す るた めに 必要な 知識に ついて 説明を します。 
Visual C+ + が 提供す る 機能を 利〗 |j した ファイル 人 ⑴カ の 力 •法 や、 リストを 使った デ 一夕 
の 竹 现 などは、 本格的な プログラムを 作成 するとき には 必须の 知識です。 

第 4 部 Windows らしい ブロ グラムを 作って みよう 

第 4 部では、 簡中 •な WWW ブラウザを 作成しながら 、敁近 Windows に淖 入され た 2 っ 
の コントロール （ツリー ビュー コントロールと HTML ビュー コントロール） の 使い方を 説 
明して いきます 。コントロールを 細かく 制御した 敁 度な アプリケーションを 作成す るのに 
これらの 知識が 役立つ はずです。 

Appendix 

Appendix では、 本 仰の 内 料を 坪 解す るのに 必要な C + +ぶ语 および ポインタ 変数に 閲 
する 解説と、 Visual C++ 6.0 より サポート された ドキュメント-ビュー •アーキテクチャ 
を 使 川し ない MFC アブリ ケー シ ョンに っいての 解説を 褐砹 しています。 C+ + 言語に っい 
てより 深く 知りたい という 力 •は、 VisualC++ に付诚 の チュートリアル、 市 版の C++ 言 
語の 解説 办 などを 参照して ください。 

•付属 CD-ROM 

本] 1 T で 作成す る ブロ グラムの ソースコードは すべて 付诚の CD - ROM に 収めて あります。 
これらの プログラムを コンパイル/突 行す るには Visua l C ++ 6.0 の 処理 系と Visual C + + 
6.0 が 動作す る琛 境が 必要です （実行可能 ファイルは 収めて いません）。 付诚 CD - ROM の 
利 州 法に ついては、 この あとの 「付 城 CD - ROM にっいて」 を 参照して ください。 



付属 CD - ROM につし、 て 



本逬で 作成す る ブロ グラムは すべて、 付 域の CD-ROM に 収めて あります。 これらの ブ 
ログ ラムを コンパイル/実行す るには、 Visual C+ + 6.0 の 処理 系と Visual C+ + 6.0 が 
動作す る 環境が 必要です。 

• 付属 CD-ROM の 構成 

付 城 CD-ROM には、 以下に 示す ような フォルダ 構成で ブロ グラムが 収められて います。 



フォルダ 


内容 


扱って いる 章 


URLMan 






bug 






DlgTest 






G1 






G2 






G3 






Hello 


画面に 「Hello World!」 と 表示 




MenuTest 






MMView 






Paste 


マウスと キーボード 入力の 受け付け 





さらに 「URLMan」 フォルダと 「MMView」 フォルダの 下には 以下のような サブ フォルダ 
があります。 

















付属 CD — ROM について 



「 MMView 」 フォルダ 


内容 




すべての 実装を 行って ある もの 










St 印 2 


ドロー ツールの 実装が 済んだ もの （その 1) 


Step 3 


ドロー ツールの 実装が 済んだ もの （その 2) 



•付属 CD-ROM ファイルの コピー 

以上の ファイルは、 付 妬 CD-ROM に無丨 ii 縮 状態で 収められ ています 0 これを コンパイ 
ル/ 灾行 する 場合には 、ハードディスク 丨 •.の 適当な 位 押に コビー 川の フォルダを 作成し、 
そこに コビーす る ことを お勧めし ます。 また、 付诚 CD-ROM から ハードディスクに ファ 
イ ルを コピーした 坳合 、それらの ファイルには 説み 取り V/ 川诚 性が 付きます ので、 ブロ パ 
ティ シートを 使; 丨1 したり、 DOS ブロン ブトで attrib コマンドを 使) |j するな どして、 読み取 
り 由: 川诚 性を はずす 必要が あるので 注. & してく ださい。 

各 ブロ グラムの 詳しい 内容に ついては、 本文 中の 説明を 参照して ください。 付诚 フロ ッ 
ピー ディスク に揭攸 したす ベての ブロ グラムは、 以 ドの 说堍 での コンパイル/ 灾行を 確認 
しました。 

CPU 

メモリ 

ハードディスク 

OS 

処理 系 

♦注意 

本 i 1 !: および 付 祕 CD-ROM に 収められ ている ブロ グラムの 名: 作 権は 名: 作界 に、 出版 椎は 
株式会社 アスキーに あります 0 これらの ブロ グラムは 私的 利 川の 範丨 用での 使⑴ 、流 パ 丨、 変 
史、 複製に ついては これを 認めます。 ただし、 本# および 付敁 CD-ROM に揭攸 されて ぃ 
る プログラムの-部を 流〗 丨丨、 または 変史 した ブロ グラムの 運丨 II 結果に ついては、 名: 作荇、 
および 株式会社 アスキーは、 いっさい で {•任を 負い かねます ので ご r 承く ださい。 
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第 ■ 部 

Visual C ++ に 

触っ てみ よ1 

Visual C + + ブ □グ ラミング という 新世界への 第一歩 
を 踏み出す ときが 来ました。 第 1 部では 、 Visual C + + 
を 使った Windows ブ □グ ラミングが どんな もの かを 
理解す るた めに、 簡 串な ブロ グラムを 作成し ます。 実 
際に コードを 書く のは、 第 1 部を 通して ほんの 数 行程 
度に すぎない のです が、 この 数 行の 意味を 理解す る ま 
での 道のりは 決して 平坦な ものではありません。 とは 
し、 え 、 Visual C ++ の 動作 原理を 知らない まま ハイ レ 
ベルな 内容に 手を 付ける の も、 生兵法と なり かね ませ 
ん 。この 段階では まだ 先を 急がず、 疑問に® じた こと 
を 1 つ 1 つ クリアし ていく 姿勢が 重要です。 まずは 基 
本を しっかり 押さえ ましょう。 



1 Visual C++ とは？ 



Visual C + + は 中なる C + + コンパイラではありません 。これは Windows アプリ ケー 
ション を 作成す るた めの 統合 说境 です。 開発を 支 接する 数々 の ツール、 Windows の 能力 
を 引き 丨丨丨 す ライブラリ、 その他 いろいろな 便利な パーツが 密接に 結び付いた システム、 そ 
れが Visual C ++ です 。しかし 構成 要ぶ が 多いだ けに 、 Visual C ++ の 企 体 像は、 なかな 
か U 通す ことができません 。そこでまず、 本ぐ では Visual C ++ の丨丨 t 界を 作り上げ ている 
パーツの 役 削を 1 っ 1 つ U ていきます 〇 Visual C + + という 開発 環境が 分坳 してきた 竹 以 
と、 その おおまかな 構成を ここで 頭に 人れ てくだ さい 0 



1.1 GUI 時代の 開発 環境 



Windows 95 の煺発 的な 流行と ともに、 日本で も グラフィック 闸 面を ベースと する バソコ 
ン 操作 環境が 一般の ものと して 定着し ました 。いわゆる GUI (Graphical User Interface) 
という やつです。 GUI は 操作 方法が 直感的で わかりやすく、 しかも 見た 丨丨が おしゃれです。 
アプリケーション ユーザーから 見て、 こんな 結構な ものはありません 0 

しかし その 反 ffii 、 GUI の 登場に よって、 アブリ ケー シ ョンの 作成は とても 而 倒で 手 問の 
かかる 作業と なりました。 たとえば 画® に“ Hello ” と 表示す る ブロ グラムを 考えて みまし ょ 
う 。 Visual C ++ が 登場す る 以前には、 これほど 単純な ことで すら、 Windows で 実現し よ 
うと 思ったら 、「ウィンドウを 作って 位 殿を 決めて 表示して …… 」 と 何十 行 もの コードを 必 
要と していた のです。 しかも、 その コードの 大部分は 本来の B 的 （文字列 表示） には ほ とん 
ど 問 係が ありません。 

Visual C+ + 以前の Windows プログラミングでは、 GUI 採用の ために 坳 加した このよ 
うな 作業は、 すべて プログラマの 負 州 •となって いました 〇 Windows プログラミングに 手を 
染める ブロ グラマには、 大 いなる 根性と 体力が 必要だった のです。 

そんな 状況の 中で 登場した のが Visual C + + 1.0 でした 〇 Visual C + + 1.0 を 使っ て 



“ Hello " を 表示す る プログラムを 作れば、 プログラマが •丨 i ： かねば ならない コードは わずか 
1 行、 しかも それは 文字列を 丨由 jlf 丨丨に 表示す る コード そのものです 。それ 以外の 部分は みん 
な VisualC ++ が 血 倒を 兄て くれます。 すなわち、 VisualC + + を 利 )|丨 する ことによって、 
プログラマは 煩わしい 作業から 解放され、 本来の 丨丨 的の みに 集中 できるようになる のです。 
そして 今、 VisualC ++ は メジャ一バージ ヨンが 6 となり、 プログラマを さらに 強力に 支 
梭 して くれる 開発 環境と なった のです。 

プログラマが 簡 中. に 効率的に プログラム 作成を 行える ようにす るた めに 、 Visual C + + 
は 多くの 便利な ツール や ライブラリを 提供して くれます 3 次節 では、 プログラマを 节助け 
して くれる これらの さまざまな ツール 類に ついて 説明を する ことにします 〇 

1.2 開発 環境の スタンダード 、 Developer Studio 

Visual C + + を 起動す ると、 図 1-1 に不 すよう な ウィンドウが 丨由丨 •丨 (jj に 衣 示されます。 この 
ウインドウが これからの Windows プログラム 開発 環境の スタン ダ一ド 、 Developer Studio 
です。 




1 . 2 開発 理 境の スタンダード 、 Developer Studio 
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ひとことで いうと、 Developer Studio は Visual C+ + の 作 菜 全体の まとめ 役です。 
Developer Studio では、 プロジェクトの 新規 作成に 始まって、 ソースコード や リソースの 
編集、 コンパイル 、奥行、 デバッグ など、 Windows プログラム 開発を 1 つの 琛境の 中で 行 
うこと がで きる のです 0 

では、 Visual C+ + と Developer Studio が どのような 偁成 で、 どのような 機能を 持って 
いるの か、 少し 贶 いてみ る ことにし ましょう。 

• Developer Studio の 画面 構成 

図 1-1 にボ したよう に、 Developer Studio は、！ £xcd や Word といった 枕 •的な Win 
dows アプリケーションと 丨**1 様に、 タイトル バー、 メニュー、 ツール バー、 ステータス バー 
といった 部分から 構成され ています が、 そのほか にも プログラム 開発を 快適に 行うた めに 
いくっかの 要素を 備えて います 0 

その 1 つが、 ワーク スペース ウィンドウです。 ここには、 现往 作％ •を 行って いる プ ロジェ 
クト （プログラム） を梆 成す る、 ファイル や クラス、 および リソースを ページに 分けて 衣// く 
する ことができます。 また、 その 右側の スペースでは ブロ グラム コード や リソースの 褊災 
を 行います （図 1-2 >〇 コンパイル 時 や デバッグ 時には Developer Studio の 下部に 也 •川の 
ウィンドウが 衣 示され、 さまざまな ti 1 丨 報を ブロ グラマに 示して くれます。 
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図 1 -2 Developer Studio で 作業 中の 場面 



1 Visual C+ + とは？ 



祕 MFC App Wizard と カスタム App Wizard 

プログラマが Visual C+ + から 受ける ご 利益は いろいろあります が、 なかで も 特筆す ベ 
き存 fr •が、 MFCAppWizard という ツールです （図 1-3 >。 なにしろ この MFCAppWizard 
は、 人 問 様に 代わって プログラムを 作って しまう のです， 




fB^tt (APPWZJPNDLL) 



く R る® I 次へ 妙> | W 7(£) I 4^ 



図 1-3 MFCAppWizard 

もちろん MFC AppWizard を 使っても:^ 喂な プログラムが ft 勋 的に ド カスカ 大!! I； 生矩 
される わけでは なく、 作成され るのは スケルトン （Skeleton : 竹 格） と 呼ばれる アブリ ケー 
シ ョンの 枠組みに すぎません 。しかし、 Windows アプリケーションは、 この 枠糾 みを 作り 
上げる までが 一 •仕 少なので、 この 部分を MFC AppWizard が 受け持って くれる ことによ 
り プログラミングの 手 問は 人 幅に 耔減 する ことになります。 

MFC AppWizard が 作り出す スケルトンは、 なかなか あなどれない 底ノ J も 秘めて いま 
す。 たとえば 「アブリ ケー シ ョンに ツール バーを 付けたい！」、 「テキスト データを ブリン 
ト アウトしたい！」、 という 程度の 機能なら、 スケルトンの 中で 突 現して くれます 。内分で 
コードを 書く 必要なん て どこに もありません。 すべて MFC AppWizard が 行って くれる 
のです 0 

さらに、 Professional Edition 以丨 •.の バージョンの Visual C++ 6.0 では、 カスタム An 
pWizard という ツール も 利用で きます （Standard Edition では、 この 機能は サポート さ 
れ ない ）〇 カスタム AppWizard を 使えば、 通常の MFCAppWizard で 作成す る スケル 
トンを さらに カス 夕 マイズしたり、 まったく 独 丨 # 丨の スケルトンを 作成で きます。 そのほか 

にも ActiveX コントロール 用 AppWizard である MFC ActiveX ControlWizard、 IIS エ 
クス テンション 用 AppWizard である ISAPI Extension Wizard など、 作成す るプ ログ ラ 
ムの タイプに よって 複数の AppWizard が用总 されて います。 また、 Visual C+ + 6.0 で 



開発 環境の スタンダード 、 Developer Studio 




は、 Win32 アプリケーション （MFC を 使わずに Windows アプリケーションを 作成す る） 
や Win32 コンソール アプリケーション U)OS ブロン ブトで 動作す る アプリケーションを 
作成す る） などの プロジェクト タイプに ついても AppWizard が 追加され ています。 これ 
によって ブロ グラムの タイプに 応じた W 適な スケルトンが ⑴ される ようになつ ています 
(ただし、 本 御では MFC AppWizard 以外の AppWizard について は 触れない ）〇 
そうは いっても、 スケルトンは しょせん スケルトン 。作成され た ツール バーには、 不必 
炎な 機能なら 一杯 あるのに、 .{fr •欲しい 機能は 拔け ています 。プリント アウトの 機能が 付 
けられても、 HH：、 の データを 説み 込む 機能はなかった りします。 

この 先、 竹 格 だけで 足りない 部分に 肉付けを していく のは、 やは 1 ) プログラマの 役 丨丨 で 
す。 その 作 袋を 助ける ために 使 川す るの が、 リソース エディタ や ClassWizard などの ツー 
ルな のです。 

# リ ソース エディタ 

Windows プログラミングでは、 しばしば リソース という ものを 利 川し ます 。リソースと 
は、 簡中 .にいって しまえば、 メニュー や アイコン、 ダイアログ ボックス など、 ブロ グラム 
の 中で 利 川され る データ パーツです。 
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リソース 形式の データは、 ブロ グラムとは 別に 作って おいて、 あとから 実行 ファイルに 
バインド （Bind: 結び付け） されます。 データと ブロ グラム コードを 分離させる この 機構に 
は、 いくつかの メリット があります。 たとえば 複雑な メニュー 処理と 複雑な ブロ グラムが 
お 互いの 相乗効果で 超 複雑になる といった 厄介 ごとが 自然に 避けられ ますし、 すでに 完成 
している プログラムの アイコン や メニュー だけを 差し替える ような 芸当 も 可能です。 

Developer Studio には、 この リソースの 作成 や 編集を 行う リソース エディタが 組み込ま 
れ ています （図 1-4) 。実際の プログラミングに おいては、 リソース エディ 夕は スケルトン 
として 作成され た メニューに 手を 加えたり、 新しい ダイアログ ボックスを 追加す るのに 利 
用し ます 。さきほど もい いました が、 AppWizard が 生成した スケルトンは、 そのままで 
は 何もで きません 。この スケルトンに 肉付けを して、 使いやすい インターフェイスを 作成 
する ために リソース エディ 夕は あるので す。 

また、 Developer Studio で、 灾行 可能 ファイル （. exe ファイル、 dll ファイル など） を 開 
いた 場合には、 リソース エディタを 使用して、 その リソースを 修正したり、 取り ⑴す こと 
も 可能です。 



• ClassWizard と WizardBar 

AppWizard と リソース エデ ィタを 使った あとで、 いよいよ ブロ グラム コードの 記述と 
いう 段附に 入って から、 ー赉 お世話になる のが ClassWizard です （図 1-5)。 




図 レ5 ClassWizard 



詳しくは 3 章で 述べます が、 Windows アプリケーションの 動作の 基本は メッセージ にあ 
ります 。たとえば ある アブリ ケー シ ョンの ウインドウで マウスが クリックされ ると、 アブ 
リ ケー シ ョンには 「マウスが クリック された」 という メッセージが 送られます 。アブリ ケー 
シ ョンは、 キーボード や メニュー、 その他 さまざまな 場所から メッセージを 受け取ります。 
それぞれの メッセージに 対して、 どのような 対処を 行う か （あるいは 無視す るか） を 細かく 
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決めて いけば、 M 終 的に アブリ ケー シ ヨンの 動作が 定まって いく わけです。 

ClassWizard には いくつかの 役割が あります が、 その 中で もっとも 大きな ウェイトを* 与 
める のが、 まさに この 「メッセージ ごとの 処理を 決めて いく」 作業です。 そのほか にも、 ク 
ラスの 新規 作成、 クラスへの 変数の 追加な ど、 ClassWizard は 後述す る クラスと いう もの 
にか かわる さまざまな 操作 も 担当して います。 クラスに ついては やはり 3 竜で 説明す る こ 
とに しまし ょう。 




図 1 -6 WizardBar 



また、 ClassWizard の 機能を 簡略 化した WizardBar も 用,® されて います （図 1-6) 。こ 
れを 使用す ると メッセージ ハンドラの 作成/ 褊粜 時に いちいち ClassWizard を 起動す る必 
要が なくなったり、 .cpp ファイルの 褊染 時に ヘッダ ファイル （上 ファイル） を ワン 夕 ッチで 
起動す る ことができる ようになり 、プログラミング がー W 快適に 行える ようになります。 
また WizardBar は ブロ グラマが 編染 中の ソースコード 位 沢を 逐一 監视 していて、 現在 犏 
集中の クラス 名、 閲 数名を 常に 敁 新の 状態に 保って 表示し ます。 おかげで ブロ グラマは 迷 
子に ならずに 済む うえ、 < 魔 法の 杖 > ボタンを 1 っ クリック する だけで 注！:！ している クラ 
スを 操作で きる という わけです 0 

參 HTML ヘルプ 

VisualC+ + には、 すべてを ハードディスクに インストールす るのは 沿 気が いる ほどの 
オンライン ヘルプ ファイルが 付 城して きます 。システムが 巨大なら ば ドキュメント も 膨大 
という わけです 。この 膨大な ドキュメントの ブラウザが HTML ヘルプです 0 

HTLM ヘルプを 使った 悄 報の ブラウジングは 非常に 快適です 。ウィンドウ 左側に 妃 胙さ 
れた 目次を ダブル クリック すれば 指定した ページが 表示され ますし、 検索 ダイアログ ボック 
スを 使えば 全文 検索が 可能です。 また [戻る]、 [次へ]、 [ブック マーク] といった WWW 
ブラウザで すでに おなじみの 操作 性は 初めて 使う ユーザー にも わかりやすい ものです。 

HTML ヘルプは 名前が 示す ように、 ドキュメントの フォーマットには HTML が 使われ 
ています （ただし、 実際には アーカイブ ファイル のように 複数の HTML ファイルが 1 つ 
の CHM ファイルに まとめられ ている） 〇 HTML について 改めて 説明は 必要ない でしょう 0 
WWW で 利用され ている あの HTML フォーマットです 。つまり HTML ヘルプは 一種の 
WWW ブラウザと いえます。 もちろん http: で 始まる URL を 指定 すれば、 ネットワーク 越 
しに 鉍 新の ドキュメントを 直接 参照す る こと も 可能です。 最近では Microsoft を 始めと し 
た ソフトウェア デベロ ッ パが 域 新の 情報を 提供す るた めに WWW を 利用す る ことは もは 
や 当たり前です 。もし VisualC++ の ドキュメントが Microsoft 独自の フォーマットで 記 




22 



1 Visual C+ + とは？ 
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0 1-7 HTML ヘルプ 

述 されて いたならば、 他社の ドキュメントを シームレスに 参照す る ことは 不可能だった で 
しょう。 

また I 丨 TML ヘルプは WWW ブラウザ である だけでなく、 ActiveX Document にも 対応 
しています。 ActiveX Document が H 物で あるかは ともかく、 おかげで HTML ヘルプには 
HTML ドキュメント だけでなく、 Microsoft Word や Excel といった ActiveX Document 

に 対応して いる アブリ ケー シ ヨンの ドキュメントを も 衣 示で きる ようになった のです。 つ 
まり プログラマが Word を 使って •丨 f いた 仆様 •丨! ： を HTML ヘルプに 表示す る こと もで きる 
という ことです。 

•デバッガと ブラウザ 

ここまで 紹介して きた ツールは、 ブロ グラム 開 発の サポート 役で あり、 VisualC ++ の 
「光」 の丨 『丨丨 を 代表す る存权 でした。 しかし 钎 さんご 存じのと おり、 プログラミング という 作 
袋には、 避けて は 通る ことので きない 「問」 もあります 0 つまり ブロ グラムの デバッグです 0 
Visual C ++ では、 AppWizard 、 リソース エディ 夕、 ClassWizard などの ツールが ブロ 
グ ラミングを 助けて くれる 代わりに プログラマの L : 丨の职 かない 部分 も 多く、 その 動作を 理解 
する のはたい へん 而 倒な 作 菜と なります 。ブロ グラマの 閱知 しない 部分で 作成され た コー 
ドが 突 際には どう 励いて いるの かを 隐 してし まう のです。 

そこで VisualC + + には、 ブロ グラムの 動作の 解析を 助ける 2 つの 機能、 非常に 強力な 
デバッガと ブラウザが 用意され ました （図 1_8)。 




1.2 開発 環境の スタンダード、 Developer Studio 
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図 1-8 デバッガを 使用して いると ころ 



デバッガを 使 川す ると ブロ グラムを 1 行ず つ# 作 させたり、 指 泡した 位 旳 まで ノ メ (に 火 
むしたり する ことができます 。朴定 の 変纹 の侦 を衣尔 しながら ブロ グラムを 火む する こと 
もで きます。 •ガブ ラウ ザは、 間数の 呼び m し陪 w や、 変数 や 沿 数の 记在 位阶と 参照 位砰、 
さらに 後述す る クラス 附 w など、 餅 的な プログラムの 惝 造を u せて くれます っ 
デバッガ も ブラウザ も、 JiilV: 作成 屮の プログラム だけでなく、 VisimlC+ + の檔擎 イン 
クルー ド ファイルまで さかのぼって デ 一夕を， ji して くれる ところに 特徴が あります。 この 
おかげで、 ブロ グラマは AppWizard が 「勝 1\| に 作り 川 した ブロ グラムの 流れ や 静的 構造 
をと ことん 追究す る ことができます， 

本, 1 ! : で 扱う プログラムでは、 デバッガ や ブラウザの 出 游 は ほとんどありません が、 Visual 
C+ + に 付 W してく る サンプル プログラム などを 解析 •する 場 •介には、 この デバッガと ブラ 
ウサが 強い 味" となって くれる でしよう。 
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1.3 便利な ライブラリ 

前節で 紹介した プログラミング 環境と 並んで、 VisimlC+ + による プログラミングの 人 
きな メリット となる ものが、 ライブラリの 存 fr: です 0 この 節では、 VisualC++ で 利 ⑴ で 
きる 2 種類の ライブラリ、 Windows API と MFC の 役割を 簡 1JM こ 説明し ます。 

• Windows API 

MS-DOS プログラミングでは、 システム コール （INT21h) を 使って、 MS-DOS の 持つ 
ファイル 人丨 丨丨ノ J や コンソール 人 川乃 機能を 呼び出す ことができ ました。 Windows プロ グラ 
ミン グで この システム コールと M 様な 役割を； |i たす ものが Windows API です。 

Windows API は、 ウィンドウの 作成 や衣ポ 、データ 出力、 マウス 人ノ j の処押 .など、 Win 
dows システムの もっとも 接 本と なる 機能を 灾现 する ライブラリです 。どんな Windows ア 
プリ ケー シヨ ンも 、かならず 何ら かの 形で Windows API を 使って います 〇 VisualC+ + 
で 作成す る アプリケーションの 中から も、 Windows API は ライブラリ 閧 数 形式で 簡 中. に 
呼び出せる ようになって います。 

ただし Visual C+ + での プログラミングに 閲 しては、 Windows API を丨丨 •丨: 接 呼び出す こ 
とは あまりありません 。これは MS-DOS プログラミングに おいて、 たとえば ファイルを 
オーブン する 際に、 システム コールの open 閲 数では なく 掠 中 ライブラリの fopen llil 数が 
使われる ことと 似て います。 つまり、 Windows API という ものは、 システム 货 りの 低 レ 
ベルな 部分で# 作す るた め、 Windows システムの 勋 作を 熟知して いなければ 使いこなせ 
ない のです。 



• クラスラィブラリ MFC 

そこで Visual C++ では、 ブロ グラマの ft 枳を 減らし、 Windows システムの 機能が もっ 
と簡 中. に利⑴ できる ように、 Windows API の丨 •.に ••枚 かぶ さって 勋作 する ライブラリが パ J 
•G: されました 。これが Microsoft Foundation Class (MFC) です 〇 MFC を も •効に 活 州す 
るた めに Visual C ++ は 卞 まれた の だと いっても 過言では ない ほど M FC と Visual C + + 
は 密接に 結び付いて います。 

Windows AH には、 非常に 多くの 関数が 用意され ています が、 それぞれが 独) >: した 関 
数で あるた め、 どの 閲 数が どんな 処押 •を 行う もの かが わかりにくく なって いました。 これ 
に対して、 MFC では クラスと いう ものを 使って 関数を 処现 内界に よって 分類して いるの 
で、 必要な 機能を 実現す るた めの 間数が U つけ やすく なって います。 

Visual C+ + が 提供す る各钝 ツールと MFC を利⑴ する ことによって Windows プ ログ 
ラミングは Windows API を そのまま 利 川して いた 頃よりも 格段に 簡中 .になる はずです。 



1 .4 What’s new? 
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1 .4 What’s new? 

ここまで Visual C + + 6.0 の溉 龙 を 紹介して きました が、 從 来からの Visual C+ + ユー 
ザ 一から 「もう わかった からど こが 変わったんだ？」 という 不滿 •の 声が 間 こえて きそうな の 
で、 ここで まとめて おき ましょう。 

Visual C+ + 6.0 を 一言で 衣 現 すれば 「熟成 バージョン」 と 呼べる でしょう。 劇的に 何 
かが 変わった わけでは なく、 広範 丨 用に 渡って 機能 迫 加 や 機能 拡張が 行われて います。 今 M 
Vhu 丨 al C ++ が バージョンアップ された 1 つの 契機と して Windows 98 の リリースが あげ 
られ ますが、 Visual C++ 6.0 が 大きく Windows 98 に 依 杯して いる わけではありません。 
付诚 する サンプル プログラムを 以て も、 Windows 98 でなければ 勋作 しない ブロ グラムは 
ごく 少数に すぎません 〇 Windows 98 で標中 装備され た Internet Explorer 4.0 ( 以 ド、 IE 
4.0) を 利 川した プログラミング 環境が 強力に サポートされ ている 点は Visual C++ 6.0 の大 
きな 魅力です が、 これ も Windows 95 に IE 4.0 を インストール すれば 济む だけの 話です。 
したがって、 Visual C+ + 6.0 での 変 1 上 办を 解説す るには 細かな 卜 ピックを#- ベる ことに 
なって しまいます 。しかし、 これは オンラインマニュアルに# 細に 解説され ている ので、 こ 
こでは U だった 変 01办 に 絞って 简中 •に 紹介す るに とどめて おきます。 

まず Developer Studio です が、 U た 丨 丨 は ほとんど 変わって いません。 しかし 熟成 バー 
ジョン だけあって （勝手にそう 呼んで いる だけです が）、 地味ながら 非货 に灾践 的な 機能が 
2 っ 追加され ています。 

1 つは IntelliSense と 呼ばれる、 テキスト エディタでの 補完 入ノ J 機能です。 これは Win 
dows プログラミングに ありがちな、 なが〜 い 識別， •であっても 、途中まで 人ノ J すれば 残りは 
H 動的に 補って 人力して くれる ありがたい 機能です 。たとえば、 「CCachedDataPathProperty」 
と人ノ J したいと しましょう （これは MFC で记 在され ている クラスの 名 前 です >〇 この 坳 介、 
「CCached」 まで 人ノ J して [ ctrt : + ] を 人力 すれば、 残りの 「DataPathProperty」 は 「I 

勋 的に 人ノ J されて しまいます。 もし V •めに を 押してし まって、 ほかに も 補 
义 候 M が あると いった 坳介 には、 リスト ボックスが ポップアップされ るので、 リストから 
笮 みのものを 選択す る だけで 済みます 。さらに、 オブジェクトれ に 続けて ピリオドを 人 乃 
したと きには、 その 才 ブジェク 卜の メンバ-なが 衣ボ されるな ど、 さまざまな 坳丨 (丨 i で MVd 
機能は プログラマを 助けて くれます 〇 人力 作 菜が 竹 略で きる 丨 •.に、 タイプ ミス も 減らせる、 
爽 にあり がたい 機能です。 

もう 1 つは、 ClassView の# 的 解析 機能です ，ワーク スペース ウィンドウに 衣 示されて 
いる ClassView には、 プロジェクトに A まれて いる クラスと その メンバが ツリー 状に 衣 示 
されます 。これまで Class View の! li 新は 編集 中の ファイルを 保# したと きに 行われて いま 
したが、 Visual C+ + 6.0 からは ファイルへの 保存を 侍つ ことなく 、入力した 商 後に その 
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姑 采 が ClassView に 反映され るよう になり ました。 したがって、 ClassView には 常に 現 か: 
の 状態が 維持され るよう になった わけです。 

また、 峋辺 ツールの 拡充 も Visual C++ 6.0 の IJK の 1 つです 〇 まず もっとも 頻繁に 利 
川す る MFC AppWizard です が、 ドキュメント-ビュー •アーキテクチャを 使わない スケ 
ル トンを 少 成す る ことができる ようになりました 。従来、 MFC を 使った Windows アブリ 
ケー シ ョンを 作成す るには、 AppWizard を 利 川す る I3i り、 ドキュメント 一 ビュー •ア 一キ 
テク チャに 促わざる をえ ませんで した 。ドキュメント 一 ビュー •アーキテクチャは ある 祝 
度以丨 •• の规悦 で、 极雜な ドキュメント （アプリケーションが 扱う データ） を 扱う アプリ ケー 
シ ョンなら ば 幼 火は ある ものの、 ちょっとした コンパクトな アプリケーションを 作る には、 
必 淡 以 I ••に 複雑で いささか ぽ丨丨 倒な アーキテクチャです。 これまで MFC は 使いたい けれど、 
ドキュメント一ビュー •アーキテクチャは 使いたくない、 という ジレンマを 感じた プロ グラ 
マは 多い と 思います が、 Visua 丨 C+ + 6.0 でよう やく これが 解消され ました。 ドキ ュメン 
トー ビュー •アーキテクチャを 使 川し ない アプリケーションに ついては、 Appendix C で 説 
明を します。 

MFC AppWizard のもう 1 つの 拡張 機能は、 エクスプローラ スタイルの アブリ ケー ショ 
ン川 スケルトンを 作成す る 機能です 。エクスプローラ スタイルとは、 ウィンドウを んム に 
分; 別し、 データを 陏 W 的に 分 »丨 して ノ I: 側に ツリー 衣/ ji し、 ここで 選択した データを イ| •側の 
ウィンドウに 衣/ するとい う、 まさに エクスプローラで 使われて いる スタイルの ことです 0 
エクスプローラ のように ファイル アクセスに 使う だけでなく、 以 近では メー ラ や fl- : 所 鉍で 
も 使われて いる ことから も わかる ように、 この スタイルの アプリケーションは 必⑴ 砘丨 用の 
U、 •いものです 。今までで も エクスプローラ スタイルの アプリケーションを 作る ことは でき 
ましたが、 AppVVizard の サポートに よって、 より 簡 中. に 作成で きる ようになりました。 こ 
れ にっいて は、 第 4 部で 触れます。 

次に ライブラリに I 丨を 移し ましょう。 Visual C+ + の バージョン アップに 伴って 拡張を 
繰り返し てきた MFC です が、/ •近では 人 幅な 変史は 行われず、 Windows システムの 新 機 
能を 取り入れる 裎 度に 落ちみ いてきました 。今!! |丨 の バージョン アップで、 MFC こそ 6.0 へ 
と バージ ョン アップし ましたが •、使われる DLL の ファイル 名は MFC42.DLL です 。メン 
バ閲 数の 拡張 や バグフィックスは 広範 丨 用に 行われて いるものの、 バージョン 畨 y •がボ すと 
おり、 新規 クラスの 追加は、 ほとんどが IE40 に閲 速す る もの だけです。 簡単に 紹介して 
おくと、 ClltmlView クラス （HTML ファイルを 衣 /j •く" J •能な ビュー クラス。 インター ネッ 
卜への アクセス 機能 も 持つ）、 CReBar クラス （ IE 4.0 で 沿 人され た 移動 丨 り •能 ツール バー）、 
CMonthCalCtrl クラス （カレンダーを 衣 >ji する、 丨丨 付の 入力に 使う コントロールを 扱う ク 
ラス） などが ill 加され た クラスです 3 

iii •後に 才ン ライン ドキュメント について 触れて おきましょう 。これは U た 丨丨 としては もっ 
とも 人き な 炎 1 Ji 点でしょう \isual C + + 5.0 までは、 Developer Studio に 組み込まれた 
InfoViewer が ドキュメント ブラウザ として 機能して いました が、 VisualC++ 6.0 からは 




1.5 最後に ひとこと 



Windows 98 以降の Windows 標準 ヘルプ システム である HTML ヘルプが これに とって 
変わる ことにな りました。 HTML ヘルプは Developer Studio から 分離 独、 •/: して 中 •休で 機 
能す る アプリケーションで すが 、 Developer Studio での 褊災 中に F 1 キーな どで 呼び出せ 
るよう に、 連携して 動作す ると ころは 変わりません 。また ドキュメントの 丨丨 次が ツリー 状 
に 衣 示されたり、 キーワード 検索 全文 検索が 町 能な ところ も 変わって いません。 すでに 
VisualC + + 5.0 から HTML を ベースと した ヘルプ システムに 移行して いた ことを 冬え る 
と、 単純に 従来の InfoViewer が ウインドウを 独、 •/: した ものと 各え てよ いでし ょう 。近年 • 
PC の 性能が 尚 上して _ lf 丨 i が 広くな 0 、 また Windows 98 では 複数の デ イス ブレイ モニタ 
を 併 川す る マルチ モニタが サポート された ことを 芩え ると、 広 人な 丨叫丨 〖丨 i をれ 効に 使って、 
Developer Studio を 開きながら M 時に ヘルプを 参照で きる ようになった ことは ブロ グラマ 
に とって 菸ば しい （？） 改辩 といえるで しよう。 



1.5 最後 (こ ひとこと 

ここまで 「 VisualC ++ で 未 朱は バラ 色！」 的な ことば かりを 取り 丨 ••げ てきました が、 + 
当のと ころは こんな 節# にいく はずがない という こと だけは Z メ •(に 留めて おいてく ださい 0 
戈 際に ブロ グラムを 組む 段に なって から、 「ハ テ？」 と 行を 傾げて しまう ことが 何度も ある 
かもしれ ません。 

VisualC ++ に 限らず、 人 规投な クラスライブラリを 利 川した 開 兌说堍 は、 ほとんどの 
場 介、 W 初の 収っ 掛かりが 非常に 恶 いのです 。そして、 クラスライブラリを 使いこな すに 
は、 その,; ^丨 •思想 や 彩に K 3 •れた 部分の ブロ グラムの 火 際の# 作な どを しっかり 列! 解す る こ 
とが 必要になります 。列! 解が できる までは、 漭の屮 を さまよって いるよう な 父 分を 味わう 
ことになる かもしれ ません。 そしてい つ 吣れ るか も わからない 漭の屮 を 進む 作 紫は、 ㈨ 倒 
で 辛い ものになる でしょう 。しかし、 ライブラリの 使いこなし 力 •がわ かって くれば、 ブロ 
グ ラミングは かならず 効 串 的に、 簡丨 jl に、 そして 楽しく 行える ようになる はずです。 

それでは 、 Visual C + + と MFC を 使いこなすべく、 2 0 以降では 灾際に プログラムを 作 
成しながら 基本と なる 知識を 身に 付けて いくこと にしましょう。 




Visual C ++ 流 

2 プログラミング!！ 



1 草では Visual C+ + とその 丨丨 t 界を ひととおり 探検しても らいました 。この 草では いよ 
いよ Visual C+ + を 利用した プログラミングの 世界に M を蹐み 人れ る ことにします。 

その 手始めに、 まずは Visual C++ が 提供す る 俺れ た ツールの 1 つ、 MFC AppWizard 
を 使った ブロ グラムの 凸 勋生 成を 体験して みまし ょう 〇 VisualC++ によって、 Windows 
アプリケーションの 作成が いかに 中. 純化され るの か、 実感して ください 0 
そして 次に、 プログラミング 言語 人 門と いえば お 約束の、 - Hello World ” ブロ グラムを 作 
成します 。ここでは#? •通の 丨由 i 面 衣 示の ほかに、 メッセージ ボックスを 利用した 表示 法に も 
挑戦し ます 〇 MFC AppWizard/ リソース エディタ/ ClassWizard を速携 させた、 Visual 
C+ + の典迆 的な プログラミング 手順を 見て ください 0 

Visual C + + 6.0 では MFC AppWizard 以外に も 多くの AppWizard が 提供され てい ま 
すが、 本 种 では もっとも 基本的な AppWizard である MFC AppWizard だけを 利用す る 
ので、 以降では MFC AppWizard のこと を 中. に AppWizard と 呼ぶ ことにします 0 

2.1 プロジェクト ジェネレータ AppWizard 



Visual C ++ で 作成す る アプリケーションは、 非常に 多くの ファイルから 構成され ます 0 
たとえば、 ブロ グラム コードが 啬 かれた ソースファイル や、 コンパイルの ための 情報が 沓 
かれた メイク ファイル、 全体の 設定を 記述した プロジェクト ワーク スペース ファイル、 さら 
に アブリ ケー シ ョンの タイトル バーに 現れる アイコンの データファイルな ども 含まれます 0 
Visual C + + では これらを ひとまとめ にして プロジェクトと 呼びます。 アブリ ケー ショ 
ンの 開発は、 甚本 的には この プロ ジヱク 卜の 中です ベて 行われます 。簡中 •にいって しまえ 
ば、 「プロジェクト 名 = アプリケーション 名」 と 思って 間違いないでしょう。 

AppWizard は プロジェクトの 基本 構成を 設定す る ツールです。 設定 内容には、 たとえ 
ば 以下のような ものが あります 。アプリケーションの 全体 像に 合わせて、 これらの 条件を 
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設记 すると、 AppWizard は それに 対応した アプリケーション の拃 組みを 設計し、 必要な 
すべての ファイルを プロジェクトに 組み込んでくれ ます。 

•プロジェクト ワーク スペース 名 （すなわち アプリケーション のれ 前） 

•プロジェクトを 格納す る フォルダ （ディレクトリ） 

♦アプリケーションの 形式 

春 ウインドウの 細部の 構成 （ツール バー や ステータス バーの イ丨無 > 

♦その他 



• AppWizardTT プロジェクトの 枠組みを 決める 

それでは 火 除に AppWizard を 利 川して 新しい プロジェクトを 作成して みま しょ 




フ 7^ル フ U シ功ト | ト クスぐ- ス | その他の ド も; r ノト | 



^3 AT L C 〇 M AppWizdfd 
^OevStudio Ad<J-^ Wizard 
LBISAPI Extension Wizard 
ド Makefile 

□(jMFC ActiveX ControfWizard 
UjMFC AppWizard (dlD 
|53 MFC AppWrzard (exe) 
f J Utility Project 
^]W 從 Application 
""1Wm32 Console Appl 

Dyr^rmc-Lmk L*)fdry 
,%jw^32 Static Lt^rary 



フ 11シ^»ト 名 吵 



|c ¥usr¥vcpr 〇 | 



P 斯 供 ス V - スを ft 成 ( fi ) 

r 






厂 



zi 



トフ: r •ム <£>• 



キヤ：/ W * 



図 2-1 プロ ジ i ク卜 ワーク スペースの 新規 作成 

まず Developer Studio の メニューから [ファイル]- [新規 作成： を 選んで ください 。す 
ると [新規 作成] ダイアログ ボックスが 衣ポ される ので （図 2-1)、 ここで [プロジェクト] 
タブの [MFC AppWizard ( exe )] を 選択して ください 。ここには プロジェクト 作成を サ 
ポートす るいくつ もの ツールが ⑴ 立され ています が 、 [MFC AppWizard ( exe )] が もっと 
も 族 本 的、 かっ 一般的な T •段です 。 [MFC AppWizard ( exe )] を 使う と、 MFC を 使って 
Windows ァプリケーションを 作成す るた めに 欠かせない、 さまざまな セットァップが 行わ 
れ ます。 この セットアップは ソースファイルの スケルトン や リソース ファイル、 ワーク ス 
ペース ファイル （Developer Studio が 使う 作衮说 境の, 15: 走 ファイル） など 広範 丨 用に 及ぶ た 
め、 AppWizard 以外ので 段で MFC アプリケーションを 作成す るには かなりの 闲 難が 伴 
います 。 Visual C ++ を 深く 理解す るまでは AppWizard の サポートは 欠かせません。 
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[MFC AppWizard ( exe )] を 選択した あとには、 M じく [新規 作成] ダイアログ ボック 
スで [プロジェクト 名] と [位 辟]、 それに [ブラット フォーム] を 指定し ます 0 
[プロジェクト 名] は 敁 終 的に 作成され る アプリケーションの 名前で あり 、 AppWizard 
が 自動 中 成す る ファイル 名 や ソースコード 中の 各 神の 名前な どの ベースと もなります 。 今 
後の プログラミング 作 菜に 密接に かかわる ものです から、 よくち •えて 指 沿して ください 0 
今 M は [ Test ] という プロジェクト 名に して おき ましよう （図 2-2)。 




lyiK フ T 1 シ功ト | W ス V - ス | その ドキ 

TL COM AppWcard 
•OevStudio A<Jd-r> Wizard 



フ でゾか 名吵 



|Tcsi 
位屋 <£> 






ブロ ジ I ク卜 名が 
決まる と 作業 フォルダ 
も 決まる 



MFC ActiveX CcntrolWcdrd 
MFC AcoWcard (dll) 

MFC AppWte^d W 

Utility Proiect 
2Wf>32 Applc^tion 
^]Wn32 Console A^picatioo 
Dyn«m<-lr* Ifcr^ry 
， jw ベ J2 S ， d，< Lfcrary 



|c •us/¥vcpf 〇 *Tes , 



衝觸 スぐ •ス «忾成(8) 






7， r ” r •ム炒 
f ノ Wr‘ で 



I ~ w 






図 2-2 プ ロジェ ク卜 名、 フォルダを 指定した ところ 



プロジェクトを 格納す る [位 1?¢] を 指 走す るには、 隣に ある <...> ボタンを クリックして、 
[ディレクトリの 選 • JK ] ダイアログ ボックスから 適， な フォルダ （ディレクトリ） を マウスで 
選択し ます 。一般的には、 あらかじめ •、丨 /州 の フォルダを 用总 して おくと よいでしょう 。[位 
敗] に 指定した フォルダの ドに、 プロジェクト ごとに フォルダが 作られ、 そこに ブ ロジェ ク 
トを 構成す るすべ ての ファイルが 格納され ます 。たとえば ここで 「 C :¥ usr ¥ vcpro 」 という 
フォルダを 選んだ 場合は、 プロジェクト 名が 「 Test 」 なので、 「 C :¥ usr ¥ vcpro ¥ Test 」 と 
いう プロジェクト 坩 の フォルダが 作成され ます u なお、 以降 本 丨 丨}: では 作衮叫 フォルダ とし 
て 「 C :¥ usr ¥ vcpro 」 を 利用す る ことにします 0 
鉍後に プラット フォームで すが、 ほとんどの 忒荇 の说 境では [ Wi 丨 132] だけが 衣ボ され、 
さらに これに チェックが 付いている でしょう から、 なにもい じる ことはありません。 ここ 
に その他の 選択肢が 現れる のは、 WindowsCE 用 開発 キットな ど、 Windows 95/ NT 以外 
の 0 S で勋 作す る アブリ ケー シ ヨンを 開発す るた めの アドオン キットを インストールして 
いる 場合です。 M 常は 5 U こする 必要はありません。 

プロジェクトの タイプと 名前、 それに 位 [? {(フォルダ） の 設定が 終 r したら、 <〇 K > ボタ 
ンを クリックして ください 。すると ここで 初めて AppWizard が 起動され、 AppWizard に 
よる 問診が 始まります 。 AppWizard で 設定す る ことができ るのは、 次の ような 要素です。 
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•ステップ 1 

作成す る アブリ ケー シ ョンの タイプと リソースで 使用す る 言語の 神: 類を 指定し ます。 
さらに、 ダイアログ ベースの アプリケーション も 作成す る ことができます 0 リソース 
に 使用す る 言語は 日本語 か 英語を 指定す る ことができます 。また、 SDI/MDI 形式を 
選択した 場合には、 ここで ドキュメント-ビュー •アーキテクチャを サポート する かど 
うかを 指 走し ます。 

•ステップ 2 

データベースの サポートを 行う かどう かを 指定し ます。 なお、 本: M では Visual C+ + 
での データベース サポートに ついては 触れません 0 
•ステップ 3 

複合 ドキュメントを サボー 卜する かどう かを 指定し ます。 複合 ドキュメントを サポート 
すると、 他の アブリ ケー シ ョンで 作成した ドキュメント や コントロールを 格納す るコ 
ン テナ アブリ ケー ショ ンや 、コンテナ アプリケーションに デ 一夕を 供給す る サーバー 
アプリケーション などを 作成す る ことができる ようにな ります。 ただし、 複合 ド キュメ 
ン卜 について は 本 •丨ト では 触れません。 オートメーションを サポートす るか、 ActiveX 
コントロールを ブロ グラムで 使 丨| 丨 する かも ここで 決定し ます。 

•ステップ 4 

アブリ ケー シ ョンに ツール バー、 ステータス バーな どの 機能を 付加す るか どうかを 
指定し ます 。ツール バーに 閲 しては、 従来の スタイルの ものを 使 叫す るか、 Internet 
Explorer で 使 川され ている ReBar を 使用す るか も 指定で きます。 MAPI/Windows 
ソケットを サポートす るかに ついても ここで 指定し ます。 さらに < 詳細設 定〉 ボタン 
を クリックした 坳介 には、 ウィンドウの スタイル や アプリケーションに 対応 付ける 拡 
张子の 神: 類な どの 指定を 行う こと も 可能です。 

•ステップ 5 

SDI/MDI 形式の アブリ ケー シ ョンを 作成す る 場 分、 その外 観を 標嘐 的な ウィンドウ 形 
式に する か、 エクスプローラ 的 名 ものにす るかを ここで 指定し ます 〇 AppWizard や 
ClassWizard が 生 •成す る コードに コメントを 付加す るかを 指定し ます。 また、 p ro f es 
sional Edition 以丨 •.の バージ ョンでは、 ここで リンクす る MFC ライブラリの 种類 （共 • 
イ f DLL/ スタティック ライブラリ） を 選択で きます。 

♦ステップ 6 

AppWizard が 生成す る クラスの 名称と、 それを 保む: する ファイルの ファイル 名な ど 
を 指定し ます。 



以上の 問診に 対して 丨" 丨矜 していく ことによって どのような アプリケーションを 作る のか 
を 決めて いくので すが、 今丨 n 丨は すべて 標嚿設 走の ままで かまわな いので 雖し いことは あり 
ません （つまり、 AppWizard が 示した 設定に 対して、 すべて 「はい」 と 応える わけです）。 
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選択肢は すべて そのままで < 次へ〉 ボタンを 5 丨叫 クリックして ください 。すると 敁 後に、 
< 次へ > ボタンが クリック でき なくなって、 問診が 終わった ことが わかります。 

もし 今までの 作 策で 設定 ミスな どが あった 坳合、 <;乂: る > ボタンを クリック すれば、 い 
つで も 前の 丨由 iifti に w る ことができます 。今 N は 何も 変 史 する ことがありません から、 この 
ままで 結構です 。ではく 終 r> ボタンを 選択し、 AppWizard に 仕事を しても らう ことに 
しましょう 。すると、 これから 作成す る アプリケーションに 問す る悄 報が 図 2-3 のように 
衣 示されます。 



AppWiwrd 丨拟 下の ft 樣で研 U り T1 シ功 めス クルトンを 生成 U ます: 



文 



魯イ 介 フ I イス （HDD アフ リク， 



CTestApp ^77 : Testh . T< 

フい 4L CMain Fw 邮”ス ： ぬぬ Frmh • Ma 价 rmcpp 

MDI 午 フレーム: CChiWFrame クラス： ChiWFrmh • ChiWF" 

tstDoch. TestDoccpp 



犯1 子 ルーム: CChiWFrarr 
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: # ュ ' CTestView ” ス： Tt 



TestViewh . TestView.cpp 



♦メイン フいム I こ ツ^ハー 加 

♦印 6^0«7从 V をサ; 

♦ 3D 0>卜0- ル 

♦共有 DLL をげ 用 （MFC42DLL〉 

♦ ActiveX j； ノト 卩-的 サ r- ト 
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フ U シ^) ト テ〜 l/W: 

c：¥usr¥vcpro¥Test 



；；： 〇 K . — \ 4^ 」 



図 2-3 作成す る アプリケーションの 悄報 



ここが AppWizard の W 後の f(l 出です。 ここで もく キャンセル〉 ボタンを クリック すれ 
ば、 前の 肉‘ 丨 f 丨丨に W る ことができます 。よければ <OK> ボタンを クリックして、 灾際に ブロ 
ジェク 卜を 也 成しても らいましょう。 

プロジェクトの 偁 築が 進む につれ て、 ファイル 名が 次々 と衣ボ され、 それが 終了す ると 
Developer Studio に >乂: ります 。これ だけの# 作で Windows の アプリケーションに 必要な 
ソースの ほとんどが 揃ってし まいました 。どんな ファイルが 作られた のか、 ちょっと U てみ 
ましょう 。メニューから [衣/ ji] — [ワーク スペース] を货 行す ると、 ワーク スペース ウイン 
ドウが 衣 小され ます 。さきほど も说 明した ように、 この ウインドウでは ウインド ウド 部に 
ぶらさがって いる タブを 操作す る ことによって、 プロジェクトに 含まれる クラス、 リ ソー 
ス 、ファイルを 切り 枰 えながら 衣 ポ する ことができます。 

AppWizard が 中 •成した ファイルを 衣氺 する には、 [FileView] タブを クリック してく 
ださい 。すると [Test ファイル] という フォルダが 1 つ 炎 示されて いるので、 これを ダブ 
ル クリックして ください 。続けて 新たに 表ボ された [Source Files] 、 [Header Files] 、 



[Resource Files ] フ オルダ も N じように ダブル クリックして 開く と、 プロジェクトに 含ま 
れ るすべ ての ファイルが 表示され ます 〇 AppWizard の おかげで、 これらの ファイルが 自動 
的に 生成され たのです （図 2-4) 0 AppWizard とは アプリケーション （ = App) の 魔法使い 
(= Wizard) のこと なのです 0 




図 2-4 ワーク スペース ウィンドウと、 生成され た ファイルの 一 霣 

AppWizard が 中 •成した 各 ファイルの 味 や 用途は 3 々で 説明し ますが、 プロジェクトと 
一 •緒に 作られた ReadMe.txt にも 概要が 夼 かれて いますから、 一度 この ファイルに 丨| を 通し 
て おくと よいで しょう 。ワーク スペース ウインドウに 衣 示されて いる [ReadMe.txt ] を ダブ 
ル クリック すると ReadMe.txt の 内界を 説む ことができます 。今の 段陪 では、 ReadMe.txt 
を U て も 坪 解で きない ことが 多い かもしれ ません。 しかし この 先 ページを: 取ね ていくうち 
に、 だんだん ブロ ジヱ クト 内での ファイルの 役割 分祀が 兄え てく るは ずです。 

AppWizard が 出力した ファイルの 中には、 アブリ ケー シ ョンの 雛彻 となる ソース コー 
ドー 式 も 念 まれて います。 すでに 述べた ように、 ブロ グラムの 竹 組みと いう 竞味 から、 こ 
れを スケルトンと 呼びます。 

スケルトンは、 これから 作る アプリケーションの 出発点と なる ものです が、 Windows ア 
プリ ケー シ ョンと して •低 限の 機能を 備えた 一人前の ブロ グラムで もあります。 次の 琐で 
はこの スケルトンを コンパイルして、 Visual C+ + が 提供して くれる アプリケーションの 
梓糾 みを 簡単に 眺めて みる ことにします。 
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鲁 ポタン 一発 コンパイル！ 

ツール バーの < ビル ド > ボタンを クリック すると、 プログラムの コンパイルが 始まり ま 
す （メニューを お好みの かは [ビル ド] 一 [ビル ド] でも" f >〇 このと き Developer Studio の 
_丨(丨丨 •には [アウトプット] ウインドウが 開き、 コンパイル 中の メッセージが 衣 示されます 0 
もし コンパイル 中に エラー や が あると ここに 衣 示されます （図 2-5)。 




ツ一 ルバ 一の [ビル ド] ボタンを 
クリック すると コンパイルが 始まる 



a *HPX ： 

ふ， 7- 又 5 〕ガィ沖 ." 

i/m. 

StdAfx.ccc 


lest • nirvj/ 


■ 


w ズ ，， avV x ラ， 仏 か 


^ • 零， 乂 パ| 


►r 



図 2-5 < ビル ド> ポタンと [アウ 卜ブツ 卜] ウインドウ 



どうです か、 図 2-6 のように 衣 示されました か？ 今 M は AppWizard が 生成した スケ 
ル トンを 変 セを 加えずに コンパイルして いるので、 何 •丨 t もな く 終了す るは ずです 0 敁 後に 
「 Test . exe - エラー 0、 と 衣 示されたら コンパイル 終 r です 0 



Test.«x« - 1?- 0 0 

上 TiKt WX f’AW 又 ”ィ桊 かろ 乂 ，| I 



0 2-6 コンパイル 終了の 画面 



コンパイルの 途中では、 スケルトン ブロ グラムを 偁成 する いくつかの ファイル 名が 順に 
衣ボ されます。 いままでの プログラミング 環境では、 このような モジュールに 分割され たブ 
ログ ラムの コンパイルには メイク ファイルの 作成 や 保 '、): という 丨 〖丨丨 倒な 作 菜が イぐ丨 ij * 欠でした 0 
しかし Visua 丨 C + + を利⑴ すれば、 そんな 苫労も 過 上 •の もの 〇 Visual C ++ はブ ロジェ ク 
トに禽 まれる 松 数の ファイルの 依む: 閲 係を 常に 把捉し、 その Ai •適な コンパイル 方法を 知っ 
ています から （メイク ファイルは Visual C + + が 「 I 分で 作成す る）、 プロジェクト がいくつ 
の ファイルで 惝 成されて いても、 <ビ ルド〉 ボタン-発で、 簡 中. に コンパイルが 灾行 でき 
るので す。 

それでは コンパイル された プログラムを 起動して みまし よう 。ツール バーの <尖 行 >ボ 
タン （•!!: 類の 隣に 欠 印が ある ボタン） を クリックして ください 。プログラムが 立ち上がる ま 
でには、 多少の 時 問が かかる かもしれ ません。 これは、 あとで 説明し ますが、 今 M の プロ 
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ジェ クトは デバッグ モードで コンパイルし たため、 アプリケーションの 実行 ファイルに 膨 
大な デバッグ 情報が 含まれて いるから です* 1 。 

プログラムが 起動す ると、 図 2-7 のように 「Test - Testl 」 と タイトルの ついた ウイン 
ドウが 開きます。 そして その 中に 「 Testl 」 という ウインドウが 開かれ ましたね 0 




図 2-7 プログラムの 実行 画面 



この ブロ グラムの ように、 1 つの ウインドウ （親 ウインドウ） の 中に 別の ウインドウ （子 
ウインドウ） を 衣 示す る アプリケーションの ことを MDI( Multi Document Interface) 形式 
と 呼びます 〇 MDI は Excel や Word など、 比較的 規模の 大きい アプリケーションで 利坩さ 
れ ます。 「俺の ブロ グラムに ゃ こんな おおげさな 枠組みは 要らない ぜ」 という" も ご 心配な 
く 。より 中. 純な アプリケーションの ための スケルトンを 作成す る 方法 も、 次 節で ちゃんと 
紹介し ます。 

ここは とにかく、 VisualC ++ が 作丨） 上げた、 この MDI 形式の プログラムで 遊んで みま 
しょう 。まず [衣 示]— [ツール バー] を 選択す ると、 ツール バーが 消えたり、 冉び衣 示さ 
れ たりし ます 。[表示]- [ステータス バー] なら ステータス バーが m えたり 表示され たり 
します 。[ウインドウ] 一 [新しい ウインドウを 開く] コマンドを 実行す ると、 新しい ウイ 
ン ドウが 開きます。 

このように 、 App Wizard が 生成した スケルトンには、 一般の Windows アブリ ケー シヨ 
ンと叼 様な 多くの 機能が W 初から 組み込まれて います。 とくに、 今 あげたよ うな 定期の 処 



*1 メニューから [ビル ド]- [欠 行] を 選択した 場 介、 あるいは ツール バーの < ブロ グラムの 灾行 > ボタ 
ン （ビック リマークの ボタン） を クリックした 場合は、 デバッグ W 钳が说 み 込まれな いため、 起# が 
•くなる。 




2.2 プログラミングの 流れを つかもう 



现 について は、 ブロ グラマが T •を 入れる 必要 さえありません。 

しかし、 スケルトンが 提供して くれない 機能 も 当然あります。 今度は [ファイル]- [開 
く] コマンドを 実行して みましょう 。すると 図 2-8 のよう な [開く] ダイアログ ボックス 力 $ 
画面に 表示され ます。 




7r 〇 MDMKI> (V ベての フパ J 」 



図 2-8 [ M く] ダイアログ 

この ダイアログ ボックスで ファイルを 指定して <開く > ボタンを クリック してみ てくだ 
さい 。残念な ことに、 ファイルの 内 W は 衣氺 されませんで したね。 なぜなら 、ファイル デ 一 
夕の 扱い" は ブロ グラムに よって W •なる からです 。テキストを 表示す るの か、 16 進 ダンプ 
を 行う のか、 グラフィック W 形と して 扱う のか、 こういった ことは 個々 の アブリ ケー シヨ 
ンの 動作に 依存す る わけで、 スケルトンの 段陏 では 決められません 0 
AppWizard が 作り 残した この 余 丨'丨 を 埋めて、 アプリケーションを 完成させる こと、 そ 
れが Visual C+ + による プログラミング なのです 0 

2.2 プログラミングの 流れを つか も 5 



前節では、 AppWizard に スケルトンを 作らせて、 それを コンパイルす るまでの 手順を 
紹介し ました。 そこで 今度は リソース ェディタ や ClassWizard も 動 H した、 もう 少し 本格 
的な プログラミングに 挑戦して みようと 思います。 

-般に、 VisualC+ + を 使って Windows アブリ ケー シ ヨンを 作る には、 次の ような ス 
テッ ブを蹐 むこと になります。 

1. プロジェクトの 設計： ブロ グラムの 動作と ウィンドウの 外) i を 決める 

2. スケルトンの 作成： AppWizard を 実行す る 

3. リソースの 編集： リソース ェディタを 使う 

4. ブロ グラム コードの 記述： ClassWizard (と ェディタ） を 実行す る 

5. コン バイ ル （デバッグ モード）： デバッグ 情報 付きの 実行 ファイルを 作る 
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6. 実行と デバッグ： 失敗なら 3. または 4. に 戻る 

7. コンパイル （リリース モード）： 完成 バージョンの 实行 ファイルを 作る 

以 ドの (では、 この' fN(i に そって、 Visual C++ の典耶 的な プログラミング 手法を 確認 
していき ましょう。 

•プロジェクトの 設計と スケルトンの 作成 

ここで 作成す る プログラムは、 2 M 類の 方法で“ Hello World!” という メッセージを 炎ポ 
します。 1 つ II の 力 •法は め: 接 ウィンドウに 义字 列を 衣 示す る もので、 もう 1 つの" 法は [衣 
ポ] 一 [ハロー] という メニューを 作成し、 この メニューを 選択す ると メッセージ ボックス 
を衣ボ するとい う ものです。 

仙 •節の スケルトンは MDI アブリ ケー シ ヨンで したが、 今 | n 丨は Visual C+ + で 指记丨 げ 能 
なもう 1 つの アプリケーション 形式、 30丨（3丨叩丨6〇0011016が丨ポ6け306)形式を使ぃましょ 
う 〇 SI)I アプリケーションは ウインドウを 1 つし か 衣 示しません 。また 今 M の ブロ グラム 
では、 ツール バーと ステ一タス バーの 衣, Ji や、 印刷 関係の コマンド など、 必贤 ない 機能 も 
すべて 取り除いて しまう ことにします （図 2-9)。 




図 2-9 プログラムの ウインドウ 構成 （ SDI 、 ツール バーな し、 ステ一タス バーな し） 

まずは スケルトンの 作成から 始め ましょう。 さきほどと 丨„1 じ 要領で [ファイル]- [新規 
作成] を 選んで 新規 作成 ダイアログ ボックスを 開き、 [MFC AppWizard(exe)] を 選択し 
てくだ さい。 また プロジェクト 名は [Hello] とします （図 2-10)。 

さて ここから が 今 M の ポイント となると ころです 。さきほどは AppWizard のな すが ま 
ま、 く 次へ >ボ タンを 押し 絞け ただけ で ソースファイルの 雛® を 作成し ましたが、 今丨丨 ，丨は 
いくつか 変更を 加えます 。図 2-1 1 のように ステップ 1 で ラジオ ボタンの 選択 位 敗を 変史 
し、 ステップ 4 で 3 つの チェック ボックスを クリアして ください 。ラジオ ボタン や チェック 
ボックスを 変更す ると、 瞬時に 左側に 表示され ている アプリケーションの 完成 形の イ メー 
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図 2-10 [新規 作成] ダイアログ ボックス 

ジが 変わる ので、 でき ヒ がり n 介を 矜 y パ こ イメージ する ことができます 0 
SDI アプリケーションを 少 成す る坳 介は、 ステップ 1 で [ MDI ] ボタンで はなく [ SDI ] 
ボタンを 選択し ます 〇 また、 [ドッキング ッール バー]、 [初期 ステ 一夕 スバ 一]、 [印刷 お 
よび 印刷 プレビュー] は 今 N は必袈 ない ので、 ステップ 4 で これらの チェック ボックスを ク 
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以丨 •.の 操作を 行ったら、 あとは さきほどと M じように AppWizard のく 終了 > ボタン、 
そして <OK> ボタンを 順に 選択 すれば、 アプリケーションに 必要な ファイルを 诌 動的に/セ 
成して くれます。 



參 リソースの 編集 

次の ステップは、 リソース エディタを 使った リソースの 褊染 作龙 です。 リソースの 編伋 
作龙 は、 ワーク スペース ウインドウの [R esource View] ページから 始めます （図 2-12) 0 





•1 x| 
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図 2-1 2 ワ一 クスべ一スウ ィン ドウの [Resource View] ページ 

[Hello リソース] という フ ォルダを ダブル クリックす るか、 その 隣に ある + 妃兮を クリッ 
ク すれば、 プロジェクト 内に 存在す る リソースの 神頌が フォルダ として 衣 示されます。 さ 
ら に、〒 みの フ ォルダを ダブル クリックす るか、 その 隣に ある + •记兮 を クリック すれば、 
ブロ ジヱク 卜に 糾み 込まれて いる その 神 類の リソース がーね; 衣 示されます。 すでに ある リ 
ソースを ダブル クリック すれば、 リソースの 神 類に 応じた エディタが 適 立 起動され ます （図 
2-13>〇 

接 本 的な リソースに ついては AppWizard が 川 をして くれます 。また 新規に 作成した 
ければ、 丨丨 的の リソース M のフ ォルダを 選択し、 イ丨 •クリック します。 すると ショート カッ 
トメ ニューが 表示され るので、 そこから [ …… の揷 入] を 実行す ると、 新しく リソースが 作 
られ ます （ …… には 状況に 応じた リソースの M 類が 人る > 。 

リソース エデ ィタが 扱う ことので きる リソースの 柿 類は 次のと おりです 。編染 する リ ソー 
スの钝 類に 応じて、 倘 々の エディタ （ダイアログ エディタ や メニュー エディタ など） が 起動 
します。 




ダ フルク リックを すると、 リソース ェテ イタが 起動す る 




図 2-13 リソース エディタの 起動 



♦ダイァログ ボックス 

鲁 メニュー 
春 ビットマップ 
♦アイコン 
♦カーソル 

•ァク セ ラレータ テーブル 
春 ストリング テーブル 
♦ツール バー 
•その他の リソース 

ブロ グラム 中で、 これらの リソースを 識別す るには リソース ID という 数侦を 使います。 
ただ、 火 際には ブロ グラム 内で どの 数侦が どの リソースを 小して いるの かを わかりやすく 
する ために、 それぞれの 数侦 には それが どの リソースを ボ すの かわかる ような 名前を 付け 
て 利 川す るの が •般 的です。 本 •丨! : では この 数侦と 名前の ことを まとめて リソース II ) と哼 
ぶこと にします。 

また、 リソース II ) のうち、 ューザーの 操作を 受け付ける ものに 付けられ ている II ) のこ 
とを とくに オブジェクト ID と 呼びます 〇 JI 体 的には メニュー 识丨1 に 付けられた リソース 
ID や丨由 i If 丨丨に 表示され る ボタンに 付けられた リソース ID が これに あたります （それぞれ メ 
ニュー ID とか コン 卜 ロール ID と 呼ばれる こと も ある ）〇 

この プログラムでは、 リソース ェディタを 使った 仆 セは ただ 1 つ、 メニューに [衣/ ji ] 一 
[ノ 、ロー] という 项丨1 を 追加す る ことです。 他の リソースは 変！ li の 必要はありません 0 
リソース ェディタには 非常に たくさんの 機能が あり、 ここで すべてを 説明す る ことは で 
きません。 今は とりあえず、 以 ドの に 従って メニューを 変! II してく ださい 。第 2 部 お 



よび 第 3 部では、 必要に応じてもう 少し 詳しく リソース エディ 夕の 使い方を 説明し ます。 

では、 ワーク スペース ウインドウの [ResourceView] タブを クリックして ください。 次に 
表不 された リソース 一!! 1 の 中から [Hello リソース] 一 [Menu] フォルダを ダブル クリック する 
と、 その フ オルダの ドに AppWizard が 生成した メニュー リソース [IDR_MAINFRAME] 
(この リソース ID の 名付け親 も AppWizard です） が 表示され ます 。この リソース ID を ダ 
ブルク リツ ク すると、 図 2-14 のよう な メニュー エディタの ウィンドウが 開きます。 




図 2-14 メニュー エディタ 



丨由 ilfU •に 衣 小され た メニューの 心 •端に ある 乍 丨'丨 の 反" 形を ダブル クリック すると、 ブロ パ 
テイ ボツ クスが 衣, されます 。ブロ パ テイ ボックスが 衣 示されたら 、[キャプション] ボッ 
クスに [衣 /J •く （& I ))] と 人力して ください （図 2-15) 0 ここでは [ ID ] ボックスには 何も 人 
力す る 必要はありません。 




図 2-15 プロパティ ボックス （その 1) 



メニュー バーに [衣尔 （ D )] と 衣 示されたら、 その ドの 空 1，1 の 長 力 •形を ダブル クリックし 
ます 。そして 今度は ブロ パ テイ ボックスの [キャプション] ボックスに レ、 ロー （& H ) ] と、 

[ ID ] ボッ クスには [ ID — CMD - HELLO ] と 入力し ます （図 2-16) 0 これで メニューに 新し 
い 項目が 追加され ました。 





図 2-16 ブロ パティ ボックス （その 2) 



_ プログラム コードの 記述 —— ClassWizard 

次は いよいよ プログラム コードの 記述です 。ここまで Visual C + + の プログラミングと 
は スケルトンに を 加える こと だと 述べて きました が、 ならば n 休 的に どの ソー スフ ァイ 
ルに、 どんな コードを # けばよ いのでし ようか？ 

この 矜 は、 3 な 以降の 説明を •淡み、 Visual C + + の プログラムの 梆 造を 押 •解 すれば、 
おのず とわ かってく るでしょう 。ここでは、 結論から いえば、 AppWizard が ル •成した 
HdloView . cpp ファイルの 中に リス 卜 2-1 のよう な 2 つの 問 数を 紀述 する だけです。 

リス 卜 2-1 追加す るすべ ての プログラム コード 

// メッセージ ボックスを 利用して 文字を 表示す る 
void CHelloView: :OnCmdHello() 

{ 

AfxMessageBox( "Hello World!"); 

> 

// ウィンドウの 画面に 文字を 害く 
void CHelloView: :OnDraw(CDC* pDC) 

{ 

CHelloDoc* pDoc = GetDocument () ; 
pDC->Text0ut(0, 0, "Hello World!"); 



C ++ 言語特 右の 「::」 演 t): 子な どに ギョッ とした 方 も 多い と 思います が、 ブロ グラムの 内 
料に 立ち 人る ことは あとの ク •に まかせ、 ここでは コード 入力の 作 菜に 話を 絞ります。 

2 つの 閲 数は、 一 U 似た ような 閲 数です が、 コーディングの 手順は 舆 なります。 まず 
は CHelloView こ OnCmdHello 閲 数から 説明し ましょう。 この 関数を 記述す るには、 Class 
Wizard の 力が 必要です。 
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Developer Studio の メニューから [衣 示]- [ClassWizard] を 選択す ると、 ClassWizard 
が 起動し、 図 2-1 7 のよう な ダイアログ ボックスが 開きます 0 
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図 2-17 ClassWizard 

ClassWizard は 〔メッセージ マップ]、 [メンバ 変数]、 [オートメーション]、 [ActiveX 
イベント]、 [クラス 惝 報] の 5 つの ページで 構成され ており、 各 ページでは それぞれ、 メッ 
セージ ハンドラの 作成と 削除 （後述）、 ダイアログ ボックスに 紀 沢した コン 卜 ロールに 対応 
する 変数の 追加と 削除 （第 2 部を 参照の こと）、 オートメーション 機能の, 设定、 ActiveX イ 
ベントの 沿 在、 クラス 怡 報の 参照と 設 记 といった ことを 行う ことができます 。ただし、 本 
# で 扱う のは、 このうち [メッセージ マップ] ページと [メンバ 変数] ページ だけです。 他 
の ページに ついての 詳細は オンラインマニュアル 等を 参照して ください。 

ここでは、 [メッセージ マップ] ページで 次の 4 つの データを 指 走し ます 。データは かな 
らず この 順 畨で指 沿して ください。 

•プロジェクト： Hello 

[プロジェクト] コンボ ボックスでは [ Hello] が 選択され ている と 思います が、 これは 

そのままで かまいません （突 際のと ころは 変! 1£ しようがない）。 

♦クラス 名： CHelloView 

[クラス 名] コンボ ボックスを 操作して [ CHelloView ] を 選択し ます。 

•オブジェクト ID : ID_CMD_HELLO 

[才 ブジェク ト ID] リスト ボックスから [ID_CMD_HELLO] という ID を 探し、 マウ 

スで クリック します 0 

* メッセージ： COMMAND 

[メッセージ] リスト ボックスから [COMMAND] を マウスで クリック します。 



• 関数 名 ： OnCmdHello 

ClassWizard の <丨 則 数の 迫 加〉 ボタンを クリック すると、 問 数名 人力の ための ダイア 
ログ ボックスが 衣 示される ので、 そこで： OnCmdHello] という 名前を 指定し ます （図 
2 - 18)。 




図 2-18 ClassWizard を 使った 関 致の 作成 



そして、 [メンバ 問 数] の 中から [OnCmdHello] を マウスで 選択し、 く コード 褊姒〉 ボ 
タンを クリック すると、 エディタが 起勋 して CHelloView::OnCmdHellolW 数の コードが 衣 
示されます 〇 ClassWizard が H 動的に IW 数を 作成して くれたの です。 ただし この 段階で 衣 
ボ される コードは 関数の 拃糾 みだけ で 中身はありません から、 次のように メッセージ ボッ 
クスを 表示す る 1 行を i 丨 I 1 き 加えます （図 2-19)。 図 2-19 では、 IntelliSense による ブ ログ 



丨 ntelhSense 櫬能 により 閣 ft の 
引 tt が 表示され ている 




図 2-19 ブ □グラム コードの 記述 




ラマ サポート 機能の 1 つして、 AfxMessageBox 閲 数の， j| 数が ツール チップに 表示され て 
いる ことに 注丨 1 してく ださい。 今後は、 閲 数の リ 丨数妆 びを 知る ためだけ に、 HTML ヘルプ 
を 参照す る N 数は かなり 減る はずです。 

AfxMessageBoxC'Hello World!"); 

以丨 ••で、 メニューから [衣, ji ] - [ ハロー ] を灾 行した ときに 呼び出される メンバ 間数の 
編 犯は 終わりです。 ところで、 この 作衮に ClassWizard を 使った わけです が、 「たった 4 
行なら ClassWizard を 使う まで もない じ ゃない か」 と 恐 われた かもしれ ません。 しかし、 
ちょっ と 待っ てくだ さい。 今 作った CHe 丨 loView::OnCmdHello 関 数を 呼び 川す 記述は どこ 
にもありません。 また、 メニューから [衣り i ]— [ ハロー ] を 実行した ときに 何が 起こる か 
も/ されて いません 。それでも、 この ブロ グラムは キ チンと 勦く のです。 という ことは つ 
まり、 この 4 行 以外に もど こかの 場所に 変更が 加えられ、 しかも それは c 丨 assWizard の 仕 
袋 だとい うこと です 。別に サンプル だから、 無观 して Class Wizard を 使った わけでは あり 
ません 。たった これ だけの 編粜 でも ClassWizard がなければ… 什 事 だから 使って いるので 
す。 この ClassWizard の肜の 化 について はまた あとで 解説す る ことにして、 次に 進み ま 
しょう。 

次に、 ウィンドウの 上に 敗 接- Hello Wor 丨 d! ” と 衣 示す る CHelloView :: OnDraw 関数の 
コー デ ィング 力 •法を 説明し ます。 こちらは ClassWizard を 使いません 0 

褊 恥す るフ ァイ ルを 開く には、 図 2-20 のように ワーク スペース ウィンドウの [ Fii e vi e w ] 
タブを クリックして 、ファイル •なから 対象と なる ファイル （たとえば、 HdloView.cpp) を ダ 
ブルク リックす るか、 または、 [ファイル]- [開く] を 選択して 、[ファイルを 開く] ダイア ロ 
グボッ クスで ファイルを 選択し ます。 しかし、 ここでは さきほど CH e ll 〇 View :: ()nCmdIIello 
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関数を 記述した 時点で HelloView.cpp が 開かれて いるので 、ファイルを 開く 操作は とくに 
必要ありません。 

では、 スクロール バーを 操作して、 次の ような 部分を 探して ください 0 



void CHelloView: :OnDraw(CDC* pDC) 

{ 

CHelloDoc* pDoc = GetDocument () ; 

ASSERT.VALID(pDoc); 

// TODO : この 壜 所に ネイティブ データ 用の 描画 コードを 追加し ます。 

> 

これは AppWizard が 自動的に 生成した スケルトンの 一部で、 CHelloView クラスの On 
Draw メンバ 関数 （CHelloView::OnDraw 閲 数） を 定義して います。 今 间 はこ こに 以下の ブ 
ログ ラム コードを 記述す る ことにします 0 

pDC->Text0ut(0, 0, "Hello World! ") ; 

これを _ 丨 F き 加えた ものが 図 2-21 です 。たった 1 行です が、 今丨 Ul の アプリケーションで 
はこれ で 十分です 〇 敁 後に 変！ した ファイルを 保存す るのを 忘れずに 行い ましよう 〇 [ファ 
イ ル]- [.丨 Vi 丨 F き 保存] を 選択 すれば もとの ファイル 名で 保存され ます 0 
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図 2-21 コードを 追加した ところ 

このように、 VisualC+ + での ブロ グラム コードの 記述 方法には ClassWizard を 利用す 
る ものと ブロ グラマが 手 作業で 行う 必要が ある ものの 2 種類が ある ことを 觉 えて おいてく 
ださい。 

なお、 ファイルを 開いたり、 閲 数を 編集す るのに ワーク スペース ウィンドウの [ClassView] 
ページを 利用す る こと もで きます。 たとえば、 さきほどの CHelloView::OnI)raw メンバ _ 
数を 編集す るには、 [ClassView] タブを クリックした のちに、 [Hello クラス] フ ォルダを 
ダブル クリックして、 プロジェクトに 存在す るすべ ての クラスを ー览 衣ボ します。 ここで 
[CHelloView] クラスの 左に ある + 記号を クリックして ください 。すると、 その ドに その ク 
ラスの メンバが 一覧表 示される ので、 ここで [〇nDraw(CDC* pDC )] を ダブル クリック 
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r れは 、ウィンドウに CHelloView::OnDraw 関数が 表/ されます （図 2-22 ) 〇 

プラス 名の 部分を ダブル クリックした 場合には クラスの 定在 ファイル （.般 にに 

レ） が ウィンドウに 開かれます 。このように ClassView を 使えば クラスの メンノ 
r ク セスす る ことができます 3 




メンバ 間数を ダ フルク リックす ると 

その 間数の* 袋が ウィンドウに* 示される 



図 2-22 [ ClassView ] ページを 利用した 間数の* 集 

•コンパイル /実行 

さ C ■、さきほどは このまま コンパイルを 行いました が、 今丨 „丨 は 少しで を 加えて コンパ づ 
ルして みましょう 0 

まず、 メニ ユーから [ビル ド] 一 [アクティブな 偁 成の 設 定] を 選んで ください。 この タ 
イア ログ ボッ クスでは コンパイル I 丨 y •に 使う プロ ジヱク 卜の 構成を 指记 します。 今丨 "丨 、ここ 
では プロジェクトの 構成を 今まで 使って いた デバッグ 丨丨 J の [ He 丨丨 (） _ Win32 Debug ] からり 
リース川の [ Hello - Win 32 Relwse ] にして みまし ょう。 選択を したら <〇 K > ボタンを ク 
リッ ク して [アクティブな プロジェクト 惝 成の 設定] ダイアログ ボックスを 閉じて くださ い 




図 2-23 プロジェクトの 橘 成の 変更 





プロジェクトの 偁 成とは、 さまざまな 说境 設定を ふ 1 i •め 込んだ ものです。 たとえば、 コン 
パイル 時に デバッグ 情報を 実行 ファイルに 塊め 込む か、 M 適 化を 行う か、 ブラウザ 情報 ファ 
イ ルを , k 成す るか、 などの •没) U が これに 穴 まれます。 これらの 设定を プロジェクトの 構成 
という 形で 极数⑴ 立して おき、 川途 に応じて 切 り抒 えれば、 膨 人な 纹の说 境设定 をい ちい 
ち 何 か 所 も いじ くりまわさずに すみます。 これが APP W 丨 zar d が刖盘 して くれた 2 桢 類の 
プロ ジヱ クトの 構成の 丨丨 •: 体です 〇• ぼしい 琛堍 115 :定の 内界は、 [プロジェクト]- [設定] を 
火む すると U る ことができます。 

プロジェクトの 構成で [Hello - Win32 Debug] を 選択す ると、 Visual C+ + は デバ ッ 
グ に必贤 な 惝 報を アブリ ケー ショ ン屮に 坪め 込みます。 これとは 反対に [ IIe 丨丨 〇 - Win32 
Release] を 選択す ると、 Visual C++ は デバッグ 悄 報を 作成し ません 。その代わり、 コン 
パイル ”叫 が Kr.tv: くなる とともに プログラム サイズが 小さくな ります。 使い分け として 
は、 アプリケーションの 問 発 中は [Hello - Win32 Debug] で 作成し、 開発 終 广丨 けに [Hello 

- Win32 Re 丨 ease] で 作成す るの が •般 的です 0 

プロジェクトの 梆 成を [丨丨 ello - Win32 Release] に 変 Oi したら、 く ビル ド〉 ボタンを ク 
リックして コンパイルして みまし よう。 

どうでした か？ 丨丨 i 後まで コンパイルで きました か？ では、 今 コンパイルした ブロ グラム 
を災 行して ください （図 2-24)。 




図 2-24 プログラムの 実行 画面 



ウィンドウの ノ,-:丨 •.隅に- Hello World!” と 衣 小され ましたね 。また、 メニューから [衣 小] 
一 [ハロー] を 選択す ると メッセージ ボックスが 衣/ される はずです。 AppWizard とリ ソー 
スエ ディ 夕、 ClassWizard など、 Visual C+ + が 提供す る 便利な ツールと MFC を 使った 
プログラミングの 敁 人の 利点は、 ウィンドウを 開いた 丨） する ような プログラムの 雑多な 部 
分を i 丨 ? かずに、 アプリケーション 水 来の 丨丨 的に そった 部分 だけを 符 くこと がで きる ように 
なること です 3 本な の サンプル でも、 それは 感じ取って いただけ たかと 思います。 
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では、 ブロ グラマが アブリ ケー シヨ ン 本来の 目的に 集中す るた めに MFC と AppWizard 
が 生成して くれた コードは いったい 何な のでしょう か？ 3 幸では AppWizard が 生成した 
コードの 謎を 探る ために、 VisualC++ (と MFC) を 利用して 作成す る プログラムの 基本 
的な 構造 や、 MFC の 基礎知識 などに ついて 説明す る ことにします。 




プログラムを 
3 解剖して みよう 



前 牮 では 非常に 舉 純な ブロ グラムを 例に Visual C+ + での プログラミング 作業を 説明し 
ました 。この プログラムで 災際に 人力した コードは、 ウィンドウへの 文字 出力に 1 行、 メッ 
セージ ボックス 衣尔 のために 1 行と、 ごくわず かなものでした 。しかし それは AppWizard 
が ル: 成した 山の ような コードが 竹 以 にあって 初めて 勋 作した のです 。いったい この 膨大な 
コードは M をす るた めの ものな のでし ようか？ 本 C では、 C+ +， 丨 •訊と Windows アプリ 
ケー シヨ ンに閲 する 知識を 解, 说 した あとに、 AppWizard が 小 •成した コードが どんな もの 
なのか、 そのぬ: 味を 探って いくこと にします 。また、 VisiuilC++ で 作成す る アブリ ケー 
シ ヨンの 生 命の 源と もい える クラスライブラリ、 MFC についても 説明し ます 0 

3.1 クラスと メッセージと MFC 

ブロ グラムの 内？ を 押 解す るサ備 として、 まずは Visual C+ + の プログラムの 基本と な 
る、 3 つの): 丨丨識 を に 人れ て もらい ましよう 0 

1 つ丨丨 は C++ 3 •沿の クラスの 役割です 3 クラスとは 、オブジェクト 指 叫 ブ ログ ラミン 
グの エッセンスを 取り 人れ る ことで、 C •沿の 構造体の 機能が 人 幅に 拡張され たもので す 
が、 ここでは 「クラスとは こんな もの」 といった 感じの 概念的な 説明 だけに とどめて ありま 
す。 Appendix では、 構造体と クラスの 比較な ど、 もう 少し 詳しい 説明を しています から、 
そちらに も ぜひ 丨丨 を 通して おいてく ださい。 

2 つ 丨 I は Windows アプリケーションの 動作を 支 fill する メッセージの 働きです 〇 Windows 
アプリケーションが どのような しくみで 動作す るの かにつ いて 説明を します 0 
そして、 3 つ 丨丨は Windows アプリケーションを 構成す る 各 神: 部品の 集合体、 MFC につ 
いてです。 VisualC+ + を 使いこなす という ことは、 すなわち MFC を 使いこなす ことに 
ほかな りません。 4： なでは その外 面 的な 部分と 内丨 W 的な 部分の 丨 时 方に ついて、 丛本 的な 溉 
念を 押さえて いくこと にします。 



3 ブロ グラムを 解剖して みよう 



♦クラスと 才 ブジェク 卜 

プログラミングとは、 いって みれば 現実の 世界を コンピュータの 上で 衣 現 （冉 現/シミ ュ 
レート） する 試みです 。このと きに 重要な のは、 扱う 対象を どのように コンピュータの デ 一 
夕と して とらえる かとい うこと で、 それが プログラムの 構成に も 人き く影郛 します。 

簡単な 例と して コン ピュー 夕の 上で 人間を 表現す る ことを 考えて みましょう 。ブ ログ ラ 
ム 中で 複数の 人 問を 扱う とき、 それぞれを 別の データと して 衣 現 する こと もで きます が、 
共通す る 要素を くくり 出した 型を 川 意して おくと、 いろいろな 処理が 単純化で きます。 

たとえば、 人は 名前/年齢/身長/体 觅 など、 個人的な 悄 報を 持って います。 また 人は ご 
飯を 食べたり、 崧 たりし ますが、 これらの 行動は # •でも ほとんど 丨 , ij じです。 この 2 つの 炎ぶ 
を 考え 合わせる と、 人と いう 存在は 以下のような データの 染合 として 衣 現で きる でしょう。 

人 { 

固有の 値： 

名前： 

年齢； 

身長； 

体重； 

• • • 

動作： 

ご飯を たべる {体重が 增え 所持金が •減る}: 

寝る •{布団 や ベッドが しわくちゃになる}: 



このように、 表現す る 対象を その 固 右 •の侦 （これを メンバ 変数と 呼ぶ） と i , j •能な 動作 （こ 

れを メンバ 関数と 呼ぶ） という 2 神: 類の 悄報 によって 表した ものが、 C + + 言語に おける ク 
ラスです。 

ただし、 クラスは あくまでも 概念を 記述した もので しかありません 〇 现灾批 界で 生きて 
いるのは 実体の ない 人では なく、 たとえば 「两 村」 という 個人です。 これと M じように、 コ 
ンピ ュー 夕の メモリの 中に も、 人と いう クラスで はなく、 クラスを 具現 化した 何 かが 存扑: 
しています 。この 何 かのこと を オブジェクトと いいます。 

次のように すると、 人 クラスの オブジェクトが コンピュータ 上に 川总 されます 。これを 
才 ブジェク 卜の 定義と いいます *1。 

人 西 村： 

人 桜 田； 

こうして 人 クラスの 才 ブジェク ト として 定義され た 「西 村」 や 「桜丨 H 」 には 人 クラスの 特 



*1 才 ブジェク トの宣 H とは 違う ことに 注 盘。 才 ブジェク 卜を 定義す ると、 その オブジェクトには メモリ 
が 割り当てられる が、 才 ブジェク 卜の 穴 笞 は その オブジェクトが ブロ グラム 内の どこかで 定義され て 
いる ことを 知らせる だけで メモリを 割り当てたり はしない。 
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徴が 0•- えられ、 たとえば 名前 や 尔 齢な どの 怡報 （メンバ 変数） を 持ち、 ご飯を 食べる、 鉍る 
といった 勅 作 （メンバ 閲 数） もす ベて 行う ことができます。 

また、 人が 中 .まれて くると きには 名前 や 性別な どの 悄 報は すでに 決まって いるよう に、 
オブジェクト も 少 成される ときに その メンバ 変数の 初期化を 行う ことができる ようになっ 
ています 。これを 行って くれる のが コンストラクタと 呼ばれる 特殊な 間数です 。コンスト 
ラ クタの J I 休 的な 使い 力は 第 2 部 以降で 説明を していき ますが、 ここでは コンストラクタ 
によって オブジェクトの 初期化が 行われる という ことを 觉え ておいて ください。 

次に プログラマ という クラスを 考えて みまし ょう 〇 ブロ グラマは 「プログラムを ノ!: く」 と 
いう 特別な 能力を 持ちます が、 他の 勋作は 多くの ぱ丨丨 で nilli の 人と 変わりません 。この 垛 介、 
人 クラスを 少し 拡张 する だけで、 プログラマ という 新しい クラスを 作る ことができます 0 
プログラマ クラスを さきほどと M 様な 形で 衣 現して みまし ょう。 

プログラマ： 人 { 

動作： 

プログラムを 書く 1 そら 害け やれ 書け I : 

} 

/ ii •初の 行の 「プログラマ： 人」 は、 ブロ グラマ クラスが 人 クラスを 特殊 化した 形で 定在さ 
れ ている ことを， G : 味し ます 。このような クラスの 特殊 化 （もしくは 拡张） を クラスの 継承と 
いい、 もとに なった クラス （ここでは 人 クラス） を丛底 クラス、 新しく 作られた クラス （プ 
ログ ラマ クラス） のこと を 派生 クラスと いいます 0 

次の 例は、 この ブロ グラマ クラスの 才 ブジェク 卜の 「丨1丨 丨丨」 を 定義し ます 0 

プログラマ 田 ロ： 

派ノ 1:. クラスは 、通常は 基底 クラスの 特徴を そのまま 受け 讲 ぎます。 たとえば 卜. の 「丨1丨丨1」 
にも 名前 や尔 齢が あり、 ご飯 だって 食べる でしょう。 ブロ グラマ クラスの 走 在の 中には、 こ 
れ らの悄 報は 明 ポ 的に, 1 5: かれて はいません が、 これらの ことは ブロ グラマが 人の— であ 
ると いう クラス 継承の 問 係から、 自動的に 定まる のです 0 

クラスの 継承は いろいろな 力 •法で 組み合わせる ことができます。 たとえば* •人から プロ 
グラマ、 ブロ グラマから ゲーム ブロ グラマ” のように 琳 承を 承: ねて いくこと も 町 能です し、 
“殿 様と カエ ルから トノサ マガ エル” のように 複数の クラスから 1 つの クラスを 生み出す こ 
とも また 町 能です。 

また、 派生 クラスでは 、基底 クラスから 受け 鞭いだ 能力を 新たに 定義し 敗す ことができ 
ます 。たとえば、 人の 動作の 1 つに“ 寝る-という ものが ありました 。皆 通に 考えれば、 こ 
れは介 R ] とか ベッドに 人る ことを 意味し ます。 しかし プログラマは 布 M や ベッドで はなく 
椅 f や 机の ドで 寝る ものです。 

そこで、 プログラマ クラスでは、 ••寝る” という 動作の 定義を 変史 して 以下の ように 書く 
ことにします 。この 定義に よって、 プログラマの 崧方が 普通の 人と 黄なる ことが 表せます。 
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3 プ □グラムを 解剖して みよう 



プログラマ： 人 { 

動作： 

プログラムを 害く I そら 害け やれ 軎け 丨 ： 

潘る I 椅子 や 机が あちこちに 移動す る丨 ： 

> 

このように 丛歧 クラスの 機能を 派， 丨:. クラスで 独 「丨 の ものに •丨丨 : き 換える ことを、 オーバー 
ライドと いいます。 クラスの 継承と 才ー バーラ イドに よって、 1 つの 浓本 的な クラスから 
非常に たくさんの 派 z |: •クラスを 作り出して いくこと がで きます。 

以丨 こで、 C + + 3 語に 閲 する 説明は とりあえず おしまいです。 本 擗 では、 C ++ 言語に _ 
する 川 舐が 現れる たびに なるべく 简中 •な 解説を 加える ようにして いますが、 より 詳しく、 敝 
密に 列! 解を したいと いう 人は Appendix A や、 オンラインマニュアルの c + + 丨？ 語 チュー 
卜 リアル、 山 •販の C + + •丨 ••沿の 解説 •丨 F などを 参照して ください 。では、 次に Windows ア 
ブリ ケー シ ヨンは いったい どのように して# いている のか、 その 敁本 動作に ついて 说明す 
る ことにしましょう。 



籲 Windows アブリ ケー シ ョンは どう 動く？ 

Windows アプリケーション の# 作は メッセージ という もので 制御され ます。 たとえば 
ウィンドウの I ••で マウスを クリック すれば、 「マウス ボタンが 押された」 という メッセージ 
と 「マウス ボタンが 離された」 という メッセージが ウィンドウに 送られ ますし、 ウィンドウ 
を移勋 すれば 「ウィンドウが 移# した」 という メッセージ がその ウィンドウに 送られます 
メッセージを 受け取った ウィンドウは それに 対応した 処押 をす る ことになります。 

例と して、 第 1 部で 作成した Hello アプリケーションの# 作を 芩 えてみ ましょう 。 Hello 
アプリケーションは、 

•[衣 ボ]- [ハロー] を 選択す ると - Hello World !” と •丨! •かれた ダイアログ ボックスを 炎 
示す る 

•クライアント 領域 のん: 丨 ••に - Hello Wor 丨 d 「 と 衣 示す る 
という 動作を 行う ものでした。 

この 場 介、 [衣 氺] 一 [ハロー] を 選択す ると、 「メニューが 選択され た」 という メッセ 一 
ジが ウィンドウに 送られます。 メッセージを 受け取った ウィンドウは 適切な 問 数を 灾 行す 
る —— すなわち 、メッセージを 処理す るか、 もしくは デフォルトの 処那 .を Windows に ま 
かせます 〇 Hello アプリケーションでは、 メッセージ によって 〇 n CmdHello 関数が 呼び出 
され、 两 而 に メッセージ ボックスが 衣尔 された わけです （図 3-1) 0 メッセージ ボックスが 
閉じられ ると OnCmdllellolitl 数は 終 广 し、 ウィンドウは | 丨 j ： び メッセージが 宋 るのを 待ち ま 
す。 ウィンド ウノ i : l ••に“ Hello World !” と衣氺 する の も M 様な 経路を 経てい ます。 ただし、 
こちらは 「ウィンドウを 描け」 という メッセージ によって 呼び出される ところが 先の 例とは 




0 3-1 メッセージ による プログラムの 実行 

與 なる 点です。 

このような 特 走の メッセージを 受け取る たびに 灾 行され る 関数の ことを メッセージ ハン 
ドラと いいます* 2 。 

Windows アプリケーションは、 このように メッセージを 受け取り、 それを 処理し、 W び 
メッセージが 送られて くるのを 待つ という 勋 作を 繰り返します 〇 これを メッセージ ループ 
といい、 この 点に Windows アブリ ケー シ ヨンと MS-DOS アブリ ケー シ ヨンの 般 人の 迫い 
があります。 

MS-DOS では、 ブロ グラマが 定めた main _ 数から ブロ グラムの 灾 行が 始まり、 ブ ログ 
ラマが 記述した 流れに そって ブロ グラムが 欠 行され ました 。ブロ グラムの 中で 文字を 表示 
する 必要が あれば、 そこで printflSl! 数な どを 欠 行す る ことによって、 MS-DOS の シス テ 
ム コールが 呼び出されて 文'} •••出力が 行われます 。つまり MS-DOS アプリケーションでは、 
ブロ グラマが 妃述 した コードが システムを 呼び出しながら 処理が 進んで いく わけです 。と 
ころが Windows では、 プログラマと システムの 役割が 逆 します 〇 Windows アブリ ケー 
シ ョンでは、 プログラマが 侪 く コードは システムから 呼び出される のです （図 3-2) 0 

いいかえ ると、 Windows の Ht 界 では プログラマは プログラムの 流れを 取り 让切 るので 
はなく、 メッセージを 受け取った ときの アプリケーションの 動作 （という W 部 的な コード） 
を紀述 するとい うこと です 。これは 要するに ものの 冬え ガを転 換 する 必要が あると いう こ 
とです。 「プログラムの 流れは これこれ こうだ」 的な 考え方で はなく 「この メッセージを も 



•の あと 説明す るが、 OnDraw 問 数は 止 確には メッセージ ハンドラで はない, 









図 3-2 Windows アプリケーションと MS - DOS アプリケーション 



ら ったら こうしよう」 とか 「こうす るには、 ここで この メッセージを もらった ときに 処 押を 
すれば よい」 的な ものの 冬え" をし なければ なりません。 

Visual C++ と Windows アプリケーション 

Visual C+ + では、 丨山 |げ丨| •に 衣/ ji されて いる ウインドウ や アブリ ケー シ ョンが 竹 那 する デ 一 
夕を 才 ブジェク ト として 扱います。 ユーザーが 才 ブジェク 卜に 対して 操作を 行う とその 操 
作は メッセージ として 操作の 対象と なった オブジェクトに 伝えられます 。そして、 オブジェ 
クトは 送られた メッセージに 応じて いろいろな 処邱を 行う わけです。 Visual C+ + が 提供 
する クラスライブラリ 、 MFC ( Microsoft Foundation Class > には、 これらの 才 ブジェク 
卜が ユーザーの 操作 （メッセージ） に対して どのような 処那 をす るの かを 记義 した クラスが 
数多く 存在して います。 

MFC は その 丨丨 的と 外 兄な どに よって 分けられた 以下のような クラスから 構成され てい 
ます 3 プ ログ ラマは すでに 州 总 されて いる ライブラリの 中の 必要な クラスを 利 川して プロ 
グラムを 開発 すれば よいので す。 



•ウィンドウ タイトル ノ境界 線 iti •人 化 ボタンな どの ウィンドウの 外枠 

•テキスト や グラフ ィッ クを衣 小したり ユーザーの 松 作を 受け付ける ウィンドウの 内部 






3.1 クラスと メッセージと MFC 



•アプリケーションが 竹现 する データ 

•ボタン や ェディット ボックス などの コン 卜 ロール 

•ブラシ や ペンな どの GDI オブジェクト 

♦その他 

MFC が從 供す る 多くの クラスには Windows アプリケーションに 井 M した 処观を 行うた 
めの コードが すでに 丨丨] されて います 。たとえば、 アブリ ケー シ ョンを 終 r する 処现 など 
がそう です 。[ファイル] 一 [終 T] を迸択 すると、 「アプリケーションの 終了」 という メッ 
セージが 発 ル: し、 その 結 沿、 OnAppExit 叫 数 （MFC が 川 している メッセージ ハンドラ 
の 1 つ） が 火む され、 ここで アプリケーションは 終 r します 〇 MFC を 使えば、 このような 
定喂 的な 処现は プログラマが ik! 述 する 必要はありません。 

一力 •、アプリケーションに 依む: する 処现に 問して は プログラマが あとで オーバーライド 
する ことを 想定して 関数が 定義され ています。 たとえば、 さきほど 使 川した OnDraw 間数 
も その 1 つです* 3 。 OnDraw 関数は 丨由 ilfii や プリンタに 問す る 出力を K 引き受ける 問 数 
です が、 MFC が 川 立した OnDraw 問 数は M もしません。 その 火 際の 処邢は プログラマが 
関数を オーバーライドして 、そこに, kl 述 する ことになります。 

ただし、 MFC を 心 •効 利 川す るた めには、 その 仆様に 従って、 プログラムの 構造を 決记 
しなければ なりません 〇 Visual C+ + の プログラミングでは、 MFC で 規定され たいくつ 
かの クラス （とその 派卞 クラス） を、 规记 どおりの T-K(i で 利 川す る必盟 が あるので す 。この 
結 米、 作成す る ブロ グラムの 梆造 はおの ずと 決定して きます 。このように、 ブロ グラムの 
偁造 にまで 影郛を 及ぼす ライブラリの ことを フレームワークと 呼びます。 

今 いったよ うに、 MFC を 利 川して アプリケーションを 惝築 しようと すれば、 ま丨然 のよう 
に プログラムの 店 本 構造を MFC の仆 様に 介 わせる 必紫 があります 。この 旭 イく 構造の 惝築 
を 行って くれる ものが、 ’ 上は AppWizard だった のです。 また、 VisualC++ の 作龙说 校 
である Developer Studio、 ClassWizard や リソース ェディタ といった 外 神ツ 一 ル も フレー 
ム ワークを I •分に サポートして、 ブロ グラマの ft 扔を 大きく 籽 減して くれる ようになって 
います。 

2 草で 記述した コードの うち、 両 if 丨丨 への 文卞列 川 力に 関しては MFC が 叩盘 した OnDraw 
閲 数を AppWizard が 「丨 勋 的に オーバーライドす るよう に処 那 をして くれたので、 「丨 分は 
コード だけを 記述 すれば よかった のです 0 •力 •、メッセージ ボックスを 衣ボ する ための 関数 
(メッセージ ハンドラ） は AppWizard が 川, して くれなかった ので、 ClassWizard を使っ 
て プログラマが 問 数を 1 から 作成した という わけです。 



*3 OnAppExitlUl 数 OnDraw 間数な どの 多くの 間数は 灾 際には 仮想 閲 数と して 定義され ている。 仮想 
丨阳 数に 問す る 詳細は Appendix A を 参照の こと。 




♦ MFC の 提供す る 部品 

ここでは、 MFC が どんな 部品を 提供し、 それらは どのような n 的で 利用され るかを 簡 
中. に 説明す る ことにし ましょう。 MFC には こんな 部品が 用 盘 されて いるんだ なと 感じて 
もらえれば、 別に これらの クラスの 1 つ 1 つを 細かく 觉 えて おく 必要はありません から、 
軽い 気分で 読み進めて ください。 

さきほど も いったよ うに、 Windows アブリ ケー シ ョンを 構成す る 部品には、 

♦ウインドウ 枠 
•ウィンドウ 内部 
♦アプリケーションが 扱う データ 
• GDI オブジェクト 
參 各種 コン 卜 ロール 
鲁 その他 

があります が、 ここでは、 この 分類に そって MFC が 提供す る クラスに ついて 説明を して 
いきます 。その 前に、 MFC 仝 体が どのような 構成に なって いるかを 図 3-3 にポ して おき 
ましょう 。図 3-3 を 兄れば わかる ように、 MFC が 提供す る クラスの ほとんどは CObject 
という クラスを おおもとに 派生して きた ものです 。この 中に、 ウィンドウ 枠の 竹理を 受け 
持ったり （CFrameWnd クラス）、 ウィンドウ 内部の 竹 理を 受け持ったり （CView クラス） 
する クラスが 数多く 含まれて います。 

























• CFrameWnd クラス 

CWnd クラスから 派 小 した クラスで、 フレーム ウインドウを 竹 柙 します。 この クラス 
の才ブ ジヱク 卜を 丨 接 作成す る ことは めったになく、 代わりに 以 ドの 4 つの 派生 クラ 
スを 使います。 

• CMDIFrameWnd クラス 

MDI アプリケーションの 一 挢 外の フレーム ウインドウ （親 ウインドウの フレーム ウイ 
ン ドウ） を 竹 押-します。 




3 プ □グラムを 解剖して みよう 



籲 CMDIChildWnd クラス 

MDI アブリ ケー シ ョンの 子 ウインドウの フレーム ウインドウを 管理し ます。 

• CMiniFrameWnd クラス 

SDI アブリ ケー シ ョンの フレーム ウインドウを 管理し ます。 

♦ COIelPFrameWnd クラス 

OLE 対丨 え: アプリケーションを 作成 するとき に 使います。 

なお、 クラス 名の 先頭に 付いている“ C” は- Class” を 意味す る もので、 MFC の クラス 
の 名前は すべて“ C ” で 始まって います 。みなさんが これから 作成す る クラスに ついても こ 
の 恨 習に ならって 名前 付けを する ことを お勧めし ます。 

ウインドウ 内部一 ビュー クラス 

Windows アブリ ケー シ ヨンは フレーム ウインドウに 囲まれた ウインドウ 内部 （これを ク 
ライアン 卜 領域と いう） を 使って、 ユーザーと 対話 （やり取り） をし ます。 クライアント 領 
域を 符理 する ための クラスが ビュー クラスです 〇 MFC は ビュー クラスと して 以 卜の 12 の 
クラスを 提供して います。 



鲁 CView クラス 

CWnd クラスから 派 牛 •した クラスで、 CScrollView クラス および CCtrlView クラス 
の 基底 クラスと なって います。 ビュー クラスが 持つ 機能の 基本的な 部分を 提供す るの 
が この クラスです。 

春 CCtrlView クラス 

CView クラスから 派生した クラス 。ユーザーが 直接 使う ことは ほとんど なく、 次の 4 
つの クラスの 基底 クラスと しての み 存在し ます。 

參 CEditView クラス 

CCtrlView クラスから 派生した クラス。 ビューに テキスト エディ 夕と しての 機能 （テ 
キ ストの 編集/文字列 検索/ / カット & ペースト など） を 簡単に 持たせる ことができ ま 
す。 この クラスに 関しては 派生 クラスを 用意す る ことなく そのまま ブロ グラムの 中で 
利用 可能です。 

♦ CListView クラス 

CCtrlView クラスから 派生した クラス 。アイコンを 使った アイテムの 一覧を 表示す る 
ことができます。 アイテムの 表示 形式には 4 つの パターンが 用意され ています。 

春 CTreeView クラス 

CCtrlView クラスから 派生した クラス 。アイコンを 使った アイテムの 一覧を 階曆 構造 
を 持たせて 表示す る ことができます。 



3.1 クラスと メッセージと MFC 









AppWizard が 生成した MMView (こ (3 、 Microsoft Foundation Class の 基本的 G 
使い方が 示さ n ています ♦アブリ ケーン ヨン 怍 成の ひな 型と して お使いく ださ 

この フ 7 イル (こ (3 MMView 5111 成して いる 各フ 7 イ ルの® 爱說 明が 含ま れ て L 


MMView.dsp J 


「T w 1 y- 一 ^^^^ _ • \ M . i ▲ ノ : 








WELCOME TO 



スプリット ウィンドウの 
上に 貼り付けられた 



ス ブリット ウイン 
ドウの 上に 貼り付け 
られた HTML ビュー 




図 3-5 ビュー 



春 CRichEditView クラス 

CCtrl View クラスから 派 也 した クラス。 CEdit View クラスに よく 似て いますが、 あち 
らが メモ 帳と 丨"1 等の 機能を 持って いると すれば、 こちらは ワード パッドと 同等の 機能 
を 持って いると いえます。 

• CScrollView クラス 

CView クラスから 派生した クラスで、 CView クラスに スクロール 機能を 追加した も 
のです。 

• CFormView クラス 

CScrollView クラスから 派 也 した クラス。 ビューに ボタン や エディット ボックス など 
を 利 川した ユーザー インターフェイスを 構築す るのに 使われます。 





3 プログラムを 解剖して みよう 



春 CDaoRecordView クラス 

CForm View クラスから 派生した クラス 〇 DAO データベースの レコードを 表示す る 
ために 使われます。 

• CRecordView クラス 

CFromView クラスから 派 中 •した クラス 〇 ODBC データベースの レコードを 衣 示す る 
ために 使われます。 

• CHtmIView クラス 

Visual C++ 6.0 で 新たに 追加され た ビュー クラスです。 名前が 示す とおり、 HTML 
ファイルを 解釈/表示 する ことができます 。衣 示す る HTML ファイルは、 ローカル 
の ハードディスク にある 必要は もちろんありません 。必要ならば 、インターネットへ 
の 接続を 行って くれます 0 

春 COIeDBRecordView クラス 

CForm View クラスから 派 中 •した クラスです。 OLE DB を 使 州 して、 データベースに 
アクセス する 場合に 使) H します。 



GDI 才 ブジェク 卜 

Windows アブリ ケー シ ヨンでは、 丨由丨 •丨 fti への グラフィックスの 出力には GDI 才 ブジェク 
卜と いう ものを 利 州し ます。 GDI 才 ブジェク 卜を する ための クラスと して MFC では 
以下のような クラスが 提供され ています 。炎 際の GDI オブジェクトの 使い ガに ついては 第 
2 部 1 疗 「 GDI は グラフィック 表示の 合言葉」 を 参照して ください。 




IESLS 



図 3-6 GDI を 利用した 画面 出力 



3.1 クラスと メッセージと MFC 



春 CGdiObject クラス 

CObject から 派生した クラス。 GDI オブジェクト としての 基本的な 機能を 提供し ます。 
また、 以下の クラスの 基底 クラスと なって います 〇 GDI オブジェクトは デバイス コン 
テキスト （詳細に ついては 第 2 部を 参照） に 描く 図形 デ 一夕な どを 管理す るた めに 使い 
ます。 

♦ CPen クラス 

鲁 CBrush クラス 

♦ CBitmap クラス 

♦ CFont クラス 

春 CPalette クラス 
籲 CRgn クラス 



コン 卜 ロールと ダイアログ ボックス 

コントロールとは、 ダイアログ ボックス や ビューの 上に 貼り付けられる ボタン や エディッ 
卜 ボックス、 リスト ボックス、 コンボ ボックス などの ことです 。これらの 部品は MFC で 
は、 以下のような クラスで 竹理 されて います。 これらの クラスは すべて CWnd クラス か 
ら 派生した ものです 。また、 ダイアログ ボックスは CDialog クラスが その 竹理を 行って い 
ます。 

ダイアログ ボックスと いくつかの コントロールの 実際の 利用に ついては 第 2 部 3 阜 「ダ 
イア ログ ボックスを 使って みよう」 を 参照して ください。 



鲁 CDialog クラス 

すべての ダイアログ ボックスの 基本と なる クラス。 ダイアログ ボックスを 扱うた めの 
閲 数を 提供して います。 

• CButton クラス、 CBitmapButton クラス 
春 CEdit クラス 

籲 CListBox クラス 

• CComboBox クラス、 CComboBoxEx クラス 

• CStatic クラス 

• CAnimateCtrl クラス 

• CListCtrl クラス、 CTreeCtrl クラス 

• CProgressCtrl クラス 

• CRichEditCtrl クラス 
參 CSliderCtrl クラス 

籲 CToolTipCtrl クラス 
參 CDateTimeCtrl クラス 



3 プ □グラムを 解剖して みよう 



• CReBar クラス 

• CMonthCalCtrl クラス 
♦その他の クラス 



アブリ ケー シ ヨンが 管理す る データ 

アプリケーションが 竹 那 する データには 人き く 分ける と 2 M 類あります 〇 1 つは メモリ 
I ••に ロードされ 现 作 使⑴ されて いる データで、 もう 1 つは ハードディスク などの^ •部 記 位 
鉍 iW •に データファイル として 保む: されて いる データです 〇 MFC では、 これらの データを 
扱うた めに 以 ドの ような クラスを ⑴立 しています 。これらの クラスを 灾際に 利〗 丨 j する プロ 
ジェク トは笫 3 部で 紹介し ます。 



• CDocument クラス 

CCmdTarget クラスから 派 十 •した クラス 。アブリ ケー シ ヨンが 使 川す る データを 竹 那 
する ための クラスで、 ビュー クラスと も 深い関係に あります （詳細に ついては 第 3 部 
を 参照） 〇 CArchive クラスの オブジェクトを 介して データを メモリと こ 次妃惊 に 保む: 
された ファイルとの 叫で やり取り する こと もで きます 0 

參 CArchive クラス 

CDocument クラスが 竹 押す る デ 一夕と ファイルの 問の 入 丨丨1 力を 行う 際に 利 川し ます 0 

♦ CRIe クラス 

CObject から 派 I •した、 ファイルを 扱うた めの クラスです。 CArchive クラスの 才ブ 
ジェ クトも 丨ん部 的には CFile クラスの オブジェクトを 利⑴ して ドキュメントと ファ イ 
ル 問の やり取りを 行って います。 

その他 

これまでに •兑 明した クラスの 多くは CObject クラス CCmdTarget クラス/ CWnd ク 
ラスから 派 中 •した ものでした 。ここでは、 これら 3 つの クラスと CDC クラス / CWinApp 
クラスに ついて 説明を します。 



• CObject クラス 

CObject クラスは、 MFC の にむ: 丫丨 •: する クラスで、 MFC が 提供す る クラスの 多く 
は CObject クラスから 派 十. した ものです 〇 この クラスは 「シリアライズ」、 「ラン タイ 
ム クラス t / i 報の 取得」、 「オブジェクトの 診断」 などの 機能を 提供し ます。 シリア ライ 
ズ / ランタイム クラスに ついては 第 3 部で 解説を します。 

春 CCmdTarget クラス 

Windows アプリケーションは、 メッセージを 処 那 する ことで 動作す る ことは すでに 述 
ベた とおりで すが、 メッセージを 処现 する ことができる クラスは、 すべて この CCmd 
Target クラスの 派 中 •クラスです 。この クラスの 派 叱 クラスと しては、 CWnd クラス 




3.2 MFC を 使った Windows アプリケーションの 基本 構成 



/CDocument クラス CWinApp クラスな どが あります 〇 4 C で 説明す る メッセージ 
マップに 問す る アーキテクチャを 提供す るの もこの クラスです。 

♦ CWnd クラス 

CWnd クラスは CCmdTarget クラスから 派生した クラスで、 画丨 fti に 表示され る 多く 
の ウィンドウの 接 本 的な 機能を 提供し ます 0 

春 CDC クラス 

Windows アプリケーションの 丨 IWJ は浓本 的には すべて デバイス コンテキスト （DC) と 
いう ものに 対して 送られます。 DC を 扱うた めの クラスが この CDC クラスです 。义卞 
を 出力したり、 M 形を 描いたり といった 作 袋は すべて この クラスの オブジェクトを 対 
象に 行われます。 DC とその 操作に ついては 第 2 部 1 挛 「GDI は グラフィックス 衣 示の 
介 舌®」 で 説明し ます。 

♦ CWinApp クラス 

CWinApp クラスは、 アプリケーションの 戈 行に 必 炎 な 初期化 ドキュメント テン ブ 
レートの 竹 押. などを 行う クラスで、 MFC を 利 川す るすべ ての アプリケーションが、 こ 
の クラスの 派 卞 クラスを 1 っ だけ 必袈 とします。 

3.2 MFC を 使った Windows アプリケーションの 
基本 構成 

MFC の溉贤 の 説明が 終わった ところで、 この 節では、 Hello プロジェクトを 例と して、 
App Wizard が 作り出す Windows アプリケーションが どのような MFC の クラスを 含み、 
それぞれが どのような 役割を 持つ のか 紹介し ましょう。 



參 プログラムを 構成す る ファイル 群 

すでに 述べた ように、 Hello プロジェクトは 非常に 多くの ファイルから 構成され ています 
か％ その 中で もとく に而贤 な ファイル か' 以ドに 示す/！ つの ヘッダ ファイル （インクルード 
ファイル、 上 ファイル） と 4 つの 灾装 ファイル （インプリメント ファイル、 .cpp ファイル） 
です 0 

• Hello.h 

• MainFrm.h 

• HelloView.h 

• HelloDoc.h 

• Hello.cpp 

• MainFrm.cpp 
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• Hello View.cpp 

• HelloDoc.cpp 



C 言語では ヘッダ ファイルを、 閲 数の プロトタイプ 宵 言 や 構造体の 定義な どを 記述す る 
ために 使いました 〇 C ++ 言語では それに加えて、 クラスの 定義 も ヘッダ ファイルに 記述 
します 。また、 ヘッダ ファイルに 対応す る货装 ファイルには クラスの メンバ 間数の 定義を 
記述し ます 〇 4 つの ヘッダ ファイル （と 対応す る 4 つの 突 装 ファイル） が あると いう ことか 
ら、 MFC アブリ ケー シ ヨンは 4 つの クラスから 構成され ている ことが 予想で きます。 そ 
れ では、 その 4 つの クラスとは どんな ものな のでし ょうか？ それぞれの ファイル （の 組） で 
は 以下のような 4 つの クラスが 定 在され ています* •«〇 

• Hello.h と Hello.cpp : CHelloApp クラス 

CWinApp クラスからの 派 4: クラス 。アブリ ケー シヨ ン 全体で 利用され る データを 竹 

理 します。 

• MainFrm.h と MainFrm.cpp : CMainFrame クラス 

CFrameWnd クラスからの 派 ス 丨: •クラス 。フレーム ウィンドウ に対する 操作を 処理し 

ます 0 

• HelloView.h と HelloView.cpp : CHelloView クラス 

CView クラスからの 派 中 クラス。 クライアント 領域に 対する 操作を 処理し ます。 

• HelloDoc.h と HelloDoc.cpp : CHelloDoc クラス 

CDocument クラスからの 派 少 クラス 0 ドキュメントを 竹 理 します。 

これら 4 つの クラスは すべて MFC が 提供す る クラスから 派生した ものです。 ユーザー 
の橾 作に よって 発 中 •した メッセージは、 メッセージ ループの 中で これらの 4 つの クラスの 
才 ブジェク 卜のう ち 適切と 思われる ものに 送られます 。メッセージを 受け取った オブジェ 
ク 卜は、 対応す る メッセージ ハンドラを 灾行 します。 

また 以上の 8 つの ファイル 以外に、 プロジェクトの 開発を 進める うちに 次の ファイル もブ 
ロジェ ク トフ ォルダに 作られます （表 3-1) 0 ただし これらの ファイルは 基本的に Developer 
Studio によって 編染 される もの ばかりな ので、 ブロ グラマが 尚 接 災 する ことは ほとんど あ 
りません 。唯一 Stdafx . h だけが ブロ グラマが 編集す る ファイルです 。この 中には w indows.h 
など システム インクルード ファイルが# include ディ レク ティブに よって インク ル一ドされ 
ています 。これらの システム インクルード ファイルは 数万 行に も およぶ |«: 人な ファイルな 
ので、 侮 N コンパイル するとた いへん 時 問が かかります 。そこで ファイルが 変更され ない 
限り、 二度と コンパイル せずに 済ます 機能が Visual C ++ に 州: & されました 。これが プリ 
コンパイル ヘッダ 機能です。 この 機能を 利用す るた めには StdAfx . h を 編集して、 対象と 



*4 火 際には アバウト ダイアログ ボックスを 衣尔 する ための クラスの 定在も 穴 まれる が、 アブリ ケー ショ 
ンの本 fn こは 閲 係ない ので ここでは 無 祝す る 
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ファイル 名 


名前 


目的 


Hello. aps 


リソース ID の 定義 ファイル 


リソース ID と 数値の 対応を 定義す る。 削除しても 
自動的に 作られる 


Hello. clw 


ClassWizard 用 作業 ファイル 


ClassWizard が 参照す る 作業 ファイル 0 削除して 
も 自動的に 作られる 


StdAfx.cpp 


プリ コンパイル ヘッダ 用 ソース 
ファイル 


プリ コンパイル ヘッダ 機能を 利用す るた めの ダミー 
ファイル 


StdAfx.h 


プリ コンパイル ヘッダ 用 ヘッダ 
ファイル 


めったに 変更され る ことのない インクルード ファ 
イ ルを 指定す ると、 ビル ド 時間が 短縮され る 


Hello.dsw 


« 

Developer Studio Workspace 
ファイル 


プロジェクトを 開く ために この ファイルを 指定す 
る 


Hello.dsp 


Developer Studio Project ファ 

イル 


従来の. mak ファイルから 変更され た。 ビル ド 手 顧 
が 記述して ある 


Hello.opt 


ワーク スペース オプション ファ 

イル 


• dsw ファイルの サボー 卜。 削除しても 自動的に 作 
られる 


resource. h 


リソース インクルード ファイル 


HeNo . rc から 参照され る インクルード ファイル 


Hello.plg 


ビル ド 結果 ファイル 


アウ 卜 プット ウィンドウに 出力され る ものと 同じ。 
ビル ドす るた びに 作られる 


Hello. rc 


リソース ファイル 


プロジェクトで 使用され るすべ ての リソースが 定 
萑 されて いる 



表 3-1 作蕖 中に 作成され る ファイル 



する インクルード ファイルを インクルード します。 ただし 頻繁に 変 史 される インクルード 
ファイルまで ためて しまう と 逆に ビル ド特丨 Kj が 延びる ことがあ るので、 沾焱 が 必要です， 

籲 ウィンドウは 見た目が 肝心 

ふ*; •を/! つのへ ッ ダフ ァイ ルと 火 焚 ファイルに 戾 しましょう 。これらの ファイルに それぞれ 
1 つず つ クラスが 记 在され ている のは わかり ましたが、 なぜ 公 初から 4 つもの クラスが 必 
贤 なので しょう か？ しかも、 たかだか 決まった 义卞 列を 衣, する だけの 丨 Iello プログラム 
でさえ、 これらの クラスを 1 つと して 竹 略す る ことは できない のです 3 この 謎を 解き明か 
すため に、 まずは ブロ グラムの 惝 造を ビジュアルな 祝 点から 芩 えてみ る ことにし ましょう。 

図 3-7 は Windows アプリケーションを ビジュアルな 拟点 で© i 祭した ものです 〇 MDI ア 
プリ ケー シ ョンと SI ) I アプリケーションでは 多少 偁 成が 迫い ますが、 店 本 的には ウィンド 
ウの 外観は、 フレーム ウィンドウ クラスと ビュー クラスの 2 神 類の クラスで 竹 列! される こ 
とがわ かります。 

さきほど も说 明した ように、 フレーム ウィンドウ クラスは、 ウィンドウ 枠 や タイト ルバ一、 
メニュー など アプリケーションの クライアント 領域 以外の 部分 （ノン クライアント 領域） を 
竹 观 する ための クラスで、 ビュー クラスは アプリケーションの クライアント 領域を 竹 理す 
るた めの クラスです。 その 一 ノアで、 ビュー クラスは マウス や キーボードからの ユーザーの 





ブ □グラムを 解剖して みよう 




入力 も符理 します。 つまり、 ビュー クラスは ユーザー インター フヱ イスを 符理 する ための 
クラス だとい うこと がで きる でしよう 。ただ、 注意して 欲しい のは 実際に フレーム ウィン 
ドウを 管理す るのは フレーム ウィンドウ クラスの オブジェクトで すし、 アプリケーション 
の クライアント 領域を 符理 する のは ビュー クラスの オブジェクト という ことです。 また、 
ビュー クラスの 才 ブジェク 卜が 符理 する のは フレーム ウインドウの 上に 重なって 表示され 
ている ビュー 才 ブジェク 卜 自身の クライアント 領域で ある こと も 忘れないで ください。 本 
托 では、 以降 クライアント 領域とは ビュー オブジェクトの クライアント 領域を 指す ものと 
します。 



籲 ウィンドウは 中身 も 肝心 

次に プログラミングの 視点から Windows アプリケーションを 探って みましょう。 今度 
はさっ きよりも 2 つ クラスが 増えて います （図 3-8) 0 という ことは、 増えた 2 つの クラス 
は 両面 上に 現れない 部分を 宵理 している ことが 想像で きます。 






図 3-8 プログラミングの 視点から 見た プログラムの 構成 



埘 えた 2 つの クラスの うち、 ドキュメント クラスは その 名前のと おり ドキュメントを 筲 
理 する ための クラスです 。ただし、 ここでい う ドキュメントとは、 アブリ ケー シ ョンが 管理 
する データの ことです。 たとえば、 テキスト エディタで 扱う ドキュメントは テキスト デ 一 
夕です し、 グラフィック スエ デ ィタで 扱う ドキュメントは グラフィックス データです。 

また、 この 祝 点から、 アプリケーションの 動作を 考えて みると、 ューザーが アブリ ケー 
シ ョンを 利用 するとい うことは、 

1. ユーザーが ビューと フレーム からなる ウィンドウ に対して 操作を 行う 

2. その 操作に よって、 アブリ ケー シ ョンが 管理して いる ドキュメントの 内界が 変更 さ 
れる 

3. ドキュメントの 変更を クライアント 領域 （すなわち 、ビュー） を洱 描両 する ことで 
ユーザーに 通知す る 

という 作業の 繰り返し だと 考える ことができます 。 この 互いに 関連す る ドキュメント/ 
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ビュー/フレーム ウインドウの 組を 符理 する のが 抱えた クラスの もう 1 つ、 アプリ ケー ショ 
ン クラスです。 そして、 これら 3 つの オブジェクトの 動作を 定 在した 3 つの クラスを まと 
めた ものを ドキュメント テン プレー 卜と いいます 。アプリケーション クラスの 才 ブジェク 
卜は、 必贤 に応じて この ドキュメント テンプレートを 参照して、 3 つの クラスの オブジェ 
ク卜 （っまり ウインドウ） を勋 的に 作成す るので す。 

AppWi 抑 rd で 作成した ブロ グラムでは、 ほとんどの 垛 合、 今 述べた 4 つの クラス （アブ 
リ ケー ショ ン クラス、 フレーム ウインドウ クラス、 ビュー クラス、 ドキュメント クラス） が 
W : 低 服 必袈 です* 5 。これらの クラスに 憷 能を) £1 加したり、 問 数を オーバーライド したりし 
て、 H 分の プログラムに 適した クラスに 作り 荇え ていく ことが Visual C + + と MFC を 利 
⑴ した プログラミングに ほかな りません。 Hello プロジェクトでは 、アプリケーション クラ 
ス としては CHelloApp 、 フレーム ウインドウ クラスには CMainFrame 、 ビュー クラスに 
は CHelloView 、 そして ドキュメント クラスには CHelloDoc クラスが 使われて います。 

鲁才 ブジェク 卜 

さて、 4 つの クラスが どのよう にして 絡み 介って いるの かは 列! 解で きました 。でも、 こ 
れらが 火 際に ブロ グラムの 中で いっ どのように 利 川され るの かは、 まだ 兄え ません。 しか 
も、 AppWizard が 4: 成した ソースファイルには どこを 探しても ma i n 関数に 相 肖す る もの 
( Windows では WinMain 間数） が W /レ丨 たらず、 プログラムが どこから 始まる のか、 まった 
くわ かりません。 それ どころ か、 AppWizard が , 丨: •成した コードの ほとんどは クラスの 定義 
ばかりで 才 ブジェク 卜の 定義は Hello . cpp の 中に 以下の たったの 1 行し かありません。 こ 
れで どうして ブロ グラムが 灾行 できる のでしょう か？ 

11111111111111111111111111111111111111 

// 唯一の CHelloApp オブジェクト 

CHelloApp theApp; 

灾 はこの コードから すべては 始まる のです。 といっても よくは わかりません が、 要する 
に Visual C + + での プログラミングの | lt 界 では、 アプリケーションの 实 行には アブリ ケー 
シ ョン クラスの 才 ブジェク 卜が 1 つ あれば いいのです 。アプリケーション も才 ブジェク 卜 
だと 思えば、 これは 当たり前の ことのよ うな 気 もします （しません か？）。 実際に アブリ ケー 
シ ョンが どのように 实 行され ていく かにつ いては、 この あとの 4 章 「フレームワークを 解 
剖して みよう」 で 詳しく 解説す る ことにして、 ここでは 残る 3 つの クラスの オブジェクト 
が どのように 定 在され るの かにっ いて 話を 続ける ことにしましょう。 



*5 AppWizard を 使わずに MFC を 利 叩した ブロ グラムを 作成したり、 AppWizard で ダイアログ ベース 
の アプリケーションの スケルトンを 作成した 場合、 および AppWizard で ドキュメント-ビュー •アー 
キ テク チヤの サポートの チェックを はずした 場合は、 この 阳 〇 ではない。 




3.2 MFC を 使った Windows アブリ ケー シ ヨンの 基本 構成 



残りの 3 つの クラスは アプリケーション クラスの 初期化 時に、 以 T のように AddDocTem 
plate 関数を 使って ドキュメント テンプレート リストに 分録 されます （Hello.cpp 内で 炫録 
されて いる） 。その あとは、 さきほど も いったよ うに、 必要に応じて アプリケーション クラ 
スの オブジェクトが 3 つの クラスの オブジェクトを 作成し ます 。この ことから わかる のは、 
ドキュメント テンプレートを 構成す る 3 つの クラスは 切っても 切れない 仲であって、 3 つ 
の クラスが そろって 初めて 一人前の 仕： 供が できる という ことです 0 

CSingleDocTemplate* pDocTemplate ; 

pDocTemplate = new CSingleDocTemplateC 
IDR_MAINFRAME, 

RUNTIME-CLASS (CHelloDoc) , 

RUNTIME_CLASS(CMainFrame) , // メイン SDI フレーム ウインドウ 

RUNTIME_CLASS(CHelloView)) ; 

AddDocTemplate (pDocTemplate) ; 



鲁ドキ ュメ ン卜ー ビュー •アーキテクチャ 

ここまでの 説明を 説み 進めて きて、 「なぜ ドキュメントと ビューを 別々 に 竹理 しな けれ 
ばなら ない のか？」 という ことを 疑問に 思った" も 多い のでは ないで しよう か？ 從 来の ブ 
ログ ラミングでは、 データの 竹 理と ユーザー インターフェイスは 特別 分離して 考えられる 
ものではありませんでした。 なぜ MFC では 明確に 分けて fT •理を 行う のでし ょう？ 
たとえば、 ワード プロセッシング ソフトの 場合を 考えて みます 。ここで 扱う ドキ ュメ ン 
卜は, 丨 F 式 指定の 付いた テキストファイルです 。文 i 丨! ^ ドキュメント） の褊浓 中は フォント 指 
走 や 細かな レイアウト 情報は 無 祝しても いいから、 中 •なる テキスト ファイル として I 由 i 面に 
衣 示で きる と 編 他の 効 中が 丨 •.がりそう です。 •方、 褊染が 済んだ あとの レイアウト 時には、 
フォン 卜の 指定、 1ズ丨 版の 人り" など、 できる 限り 出力 機への 出力と M 等な ものを 丨由 丨而 に 出 
力 させたい はずです 。ドキュメントの 内 料は 丨"1 じで も、 II 的 や 必要に応じて その 衣 現 方法 
は 複数# 任します。 このような ときには、 やはり ドキュメントと ビューは 別な ものと して 
竹 现 して、 必要に応じて その ビュー （衣 現） を 切り 荇 える 方法が 打 効の ように 思えます 0 
このように、 ドキュメントと ビューを 別々 に荇理 する ことには 「アブリ ケー シ ヨンが 膂 
现 する データを 丨 I 的と 必要に応じて いろいろな 形で 衣 現で きる」 という 利* が あるので す。 

MFC では 1 つの ドキュメントに 対して、 複数の ビューを 実装す る 機構が 用意され てい 
ます。 これを ドキュメント 一 ビュー •アーキテクチャと いいます 。ドキュメント 一 ビュー • 
アーキテクチャに ついては、 第 3 部で 实際に プログラムを 作成しながら 説明を します。 




フレームワークを 
4 解剖して みよう 



これまでの 0 では Visual C + + を 使った プログラムが、 MFC で 定義され たいくつ かの 
クラスと それらの クラスを 使った 特记 の処坪 の拃糾 み （フレームワーク） の 中で# 作す る こ 
とを •说 明し ました 。フレームワークは、 Wi 丨 idows から 送られて きた メッセージを 受け取る 
と、 適切な メッセージ ハンドラを 呼び 丨 丨丨 すらし いという ことは わかっても、 いったい それ 
が どのような しくみで 行われて いるの か z メ U こなる ところです。 そこで 本 0 では、 ついに フ 
レーム ワーク 内部へ とせ まって みる ことにします。 

ここでは 2 C で 作った Ilello プロジェクトを ブロ グラム 例と して 扱う ことにします。 こ 
の ブロ グラムが 火 際に# 作 するとき には、 どういった) 《( け; で、 どういった 処现 が义 行され 
るの か、 プログラマが 記述した 処押 だけでは なく フレームワーク 内部の 勋作 もため て追っ 
てみ る ことにし ましよう。 

なお、 本ゥ の站 題は かなり 雔し いこと なので、 今す ぐ わかる 必要はありません。 が、 MFC 
を 川いて プログラミングを 行う 以上は、 MFC を 利 川した アプリケーションの 動作を 知って 
いて 拟は ありません から、 何度か 丨丨を 通して ぜひ 理解して ください。 



4.1 プログラムの 実行は WinMain から？ 



MS-DOS では プログラムは main 問 数から 火 行が 始まった ように、 Windows プログラム 
の 火む は WinMain lit] 数から 始まります。 したがって、 火 行の 流れに そって コードを 読み進 
めて いくとす ると、 まずは WinMain 問 数からで す。 といきたい ところで すが \AppWizard 
が 生 成した コードの 中には、 どこを どう 探しても WinMain 問 数は のっかりません。 

Q1 いったい どこから プログラムの 実行は 始まる のです か？ 

A1 CHelloApp クラスの オブジェクト がまず 定義され ると ころから プログラムは 始ま 
ります。 



4 フレームワークを 解剖して みよう 



Windows アプリケーションでは、 WinMain 閲 数から その 灾行は 始まります 〇 が 、その 
前に 以ド のように グローバル オブジェクト （theApp) が 定義され ている ことを 思いだ して 
ください。 



11111111111111111111111111111111111111 
// 唯一の CHelloApp オブジェクト 

CHelloApp theApp; 

したがつ て、 WinMain 閲 数が 突 行され る 前に CHelloApp クラスの オブジェクトを 定義 
する ために CHelloApp クラスの コンストラクタが％ 行され る ことにな ります。 しかし、 龙 
際には、 以ド のように CHelloApp クラスの コンスト ラク 夕は 何もして いません。 



CHelloApp: :CHelloApp() 

{ 

// T0D0 •• この 位 ! ■ に 構築 用 コードを 追加して ください。 

// ここに Initlnstance 中の 重要な 初期化 処理を すべて 記述して ください。 

> 

CHelloApp クラスは CWinApp クラスの 派生 クラスで すから、 CHelloApp::CHello 
Applltl 数の 灾行の 前には CWinApp :: CWinApp 問 数 （CWinApp クラスの コンスト ラク 
夕。 MFC 内で 定在 されて いる） が 呼び m されます。 実は、 ここで さまざまな 初期化が 行わ 
れ るので す 0 

CWinApp::CWinApp 閲 数が 実行され、 初期化が 終了す ると、 いよいよ winMain 閲数 

の实 行が 始まります 〇 3 草では、 アプリケーションの 突 行には アプリケーション クラスの 
才 ブジェク トが 1 つ あれば よいな どと いいました が、 やはり、 アプリケーションの 実行に 
は WinMain 閲 数が 必要な のです。 



Q 2 しかし、 WinMain 関数 も 見当たりません が？ 

A2 WinMain 関数は フレームワーク （MFC) の 中で 定義され ています。 



theApp が走峩 された あとに 实行 される WinMain 関数は、 実は フレームワークの 中で 定 
族され ています。 つまり、 MFC を 使って 作った Windows アプリケーションは、 すべて 同 
じ WinMain 閲 数を 使って いるので す。 ただし 正確に 解説す ると、 実際には winMain 関 数 
は定 在され て おらず、- tWinMain 閲 数が 定義され、# define によって この 問 数が WinMain 
間数と して 扱われて います。 さらに、 jWinMain 関数では AfxWinMain 間数を 呼び出す、 
1 行が, 丨己述 されて いる だけな ので、 WinMain 間数の 実体は Afx WinMain 関数と もい えま 
す。 こうした 込み入った 事情は あります が、 ここでは WinMain 間数を MFC アブリ ケー 
シ ョンでの スタート アップ 関数と して 解説を 続けます。 



4.1 プログラムの 実行は WinMain か！ 3? 
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フレームワークが 提供す る YVinMain 間数は、 非常に シンプルな 構成で、 フレーム ワー 
ク内 部の 初期化 処理を 除けば、 実行す る 関数は、 CWinApp クラスの メンバ 関数、 



• Init Application 閲数 

• Initlnstance 関数 

• Run 関数 



の 3 つ だけです。 WinMain 関数は、 このように 決まりきった 関数し か丨 1 T •び 出さず、 しかも 
その コードは MFC の 中で 定義され ていて、 冉定義 する ことは できません。 とすれば、 作 
成した アプリケーション はこの 1 丨 1 からどの ようにして； 行され るので しょう か？ ’ 欠は この 
あたりが C+ + 言語の 妙で あり、 菸 価を 発揮す ると ころな のです 。詳細は Appendix A に 
誠り ますが、 C+ +酋 語の 仮想 関数と いう 機能を 利) H すれば、 义際に 呼び 川され る閲 数を 
後から 苽し样 える ことができる のです。 すでに コンパイル 済みの 問 数で あつても それは 1 げ 
能です。 つまり、？ Bi 的に 使われる WinMain 問 数は すでに ライブラリ という 形で コンパ 
イ ルが 消んで しまって いる にもかかわらず、 ユーザーが 作成した 間数を 呼び ⑴す ことが 吋 
能と いう ことです。 



Q 3 InitApplication 関数と Initlnstance 関数を 差し替えて、 アブリ ケー シ ヨンの 初期 
化を する には どう すれば よいので すか？ 

A 3 CWinApp クラスの 派生 クラスで Initlnstance 関数を オーバーライド します。 



奥は、 CWinApp::Init Application IKI 数と CWinApp::InitInstancelW 数は 仮想 関数と して 
定 在され ています 。仮想 問 数とは、 中 •にいって しまえば、 ブロ グラム 灾行丨 ほの 义際 の才ブ 
ジェク 卜の 3? によって、 灾 行され る 関数が 決定す る閲 数の ことです （詳細は Appendix A を 
参照 >〇 したがって、 CWinApp クラスの 派 叱 クラス （Hello プロジェクトでは CHelloApp 



/cWinApp\ 



inApp\/CHelloApp\ 



InitApplication 関数 
Initlnstance 関数 
Run 関数 




Initlnstance 関数 



継承 



Run 関数 





CWinApp クラス 
の 関数が 見える 

この 関数は 
オーバーライドした 

CWinApp クラス 
の 関数が 見える 



図 4-1 仮想 関数の オー パーラ イド 
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4 フレームワークを 解剖して みよう 



クラス） で InitApplication 関数と Initlnstance 関数を オーバ一ライドして、 そこに 初期化 
処理を 記述 すれば よいので す （図 4-1 >〇 WinMain 閲 数は CWinApp クラスの 才 ブジェク 

ト （afxCurrentWinApp) に対して InitApplication 関数と Initlnstance 関数を 実行し よう 

とします が、 才 ブジェク 卜の 实 際の 细 •は プログラマが 定 在した 派/ 1:. クラスの 喂 （QieiioApp 
クラス） ですから、 ここで 才ー バーラ イドした Init Application 関数と Initlnstance 関数が 
呼び出され、 うまい 具合いに 初期化が 行われる ことになります 0 

こつして CWinApp クラスの 2 っの メンバ 関数に よって アプリケーションの 初期化が 行わ 
れ ますが、 実際に 利 川す るのは CWinApp::InitInstance 関数 だけです 0 以前 は 〇 丨句 じ アブリ 
ケー ショ ンを 複数 |n] 時に 起動す る 場 介に、 敁 初の I っを 起動した ときに だけ 必炎 になる 初期 

化 作業を 行うた めに CWinApp::InitApp 丨 ication 関数を 使 川し ましたが、 現在では 使われて 
いません。 现 在では アブリ ケー シ ョンを 起勋 する たびに、 常に CWinApp :: InitApplication 
_ 数 か 呼 ひ 出されて しまう からです 0 この 動作は cWinApp::InitInstance 関数と 同じです 
から、 今では 不要の メンバ 閱数 となって います。 なお、 CWinApp :: InitApplication メンバ 
間数は 现迕 でも 残されて はいます が、 これは/ 丨:換 性を 保った めに すぎません。 

Q 4 InltApplication 関数 や Initlnstance 関数を 実行した あとは どうなる のです か？ 

A 4 Run 閧 数を 呼び出し、 メッセージ ループを 実行し 統 けます。 

Windows アブリ ケー シ ョンでは、 Windows から W く メッセージを 処理し ない 限り、 まっ 
たく 身動きする こと さえで きません。 そこで、 すべての Windows アプリケーションには、 
メッ セージ ループと 呼ばれる メッセージを 処理す る ループが 必要になります。 メッセージ 
ループの |丨 的は、 Windows から メッセージを 受け取り、 その メッセージを 処理で きる 才ブ 
ジェク 卜に 送り付ける ことです。 才 ブジェク 卜は、 受け取った メッセージを 判断して 適切 
な 閲 数 （メッ セージ ハンドラ） を 実行し ます。 ブロ グラマが 記述した コードの ほとんど はこ 
の メッセージ ループの 中から 呼び 丨丨丨 される のです 

メッ セージ ループは フレームワーク によって 提供され ている ので、 ブロ グラマが わざ わ 
ざ紀述 する 必要はありません。 メッセージ ループの 実体は CWinApp::Run 間数の 中に ある 
無限ループ であり、 メッセージを 受け取って は その メッセージを 適当な オブジェクトに 送 
り 付ける 処理を 繰り返します。 次 節では、 WinMain 関数から CWinApp::Run 関数が 呼び 
川され、 メッセージ ループが 開始され た あとの 動作を 説明し ます。 




4.2 メッセージの 処理 
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4.2 メッセージの 処理 

前節では、 アプリケーションが 起動して から、 メッセージ ループに たどり 着く までの 過 
程を 説明し ました。 しかし、 メッセージ ループの 前に 行う 処理は あくまでも 初期設定で、 
Windows アプリケーションの 中心は メッセージ ループの 間に 呼び出される メッセージ ハ 
ン ドラに ある ことは すでに おわかり でしよう 。本節では、 Hello プロジェクトで 記述した 
CHelloView::OnDraw 間数を 例に、 メッセージを 受け取って から メッセージ ハンドラが 呼 
び m される までの 流れを 説明し ます。 



純粋 仮想 関数 

CView クラスの 定義では、 CView ::〇 nDraw 関数の プロトタイプ 宣言は 以下の ようになつ 
ています。 

virtual void OnDrawCCDC* pDC) = 0; 

プ □卜 タイプ 宣言の 後ろの 「= 0 J は、 この メンバ 関数が 純粋 仮想 関数で ある ことを 示して 
います ◊純粋 仮想 関数を 含んで いる クラスの オブジェ ク 卜は 作る ことは できません。 かなら 
ず その クラスの 派生 クラスを 定義して 純粋 仮想 関数を オーバーライドし なければ なりません。 



Q1 AppWizard が 生成した コードでは、 どこから も CHelloView :: OnDraw 関数が 呼 
び 出されて いないのに、 なぜ この 闋 数が 実行され るので すか？ 

A 1 フレーム ワークの 中に OnDraw 関数を 呼び出す コードが あるから です。 

CView クラスの メンノ く 問 数の 1 つに OnPaint l«j 数が あります 〇 CView ニ OnPaint 閲 数は 
デフォルトでは、 OnDraw 問 数を 呼び出します。 そして、 このと き实 際に 呼び出され るの 
が オーバ一ライド をした CHelloView::OnDraw 関数な のです 0 



Q 2 いつ CView :: OnPaint 関数が 呼び出され るので すか？ 

A 2 画面の 描画を 要求す る メッセージ （ WM _ PAINT ) が Windows から アブリ ケー シヨ 
ンに 送られて きたと きです。 

メッセージが Windows から 送られて きたと きに 呼び出される 関数を メッセージ ハンドラ 
と 呼ぶ ことは すでに 説明し ました。 Windows には 非常に 数多くの メッセージが 定義され てい 
ますが、 その 1 つ 1 つに メッセージ ハンドラが 1 対 1 に 対応して います。 CView::OnPaint 
IW 数 も メッセージ ハンドラの 1 つで、 WM_PAINT メッセージに 対応して います。 
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4 フレームワークを 解剖して みよう 



つまり、 Windows から WM_PAINT メッセージが アプリケーションに 送られて くると、 
フレームワーク によって CView :: OnPaint 閲 数が 呼び出される という わけです， 

Q 3 WM — PAINT メッセージは どのような ときに 送られて くるので しょう？ 

A 3 ウインドウの 再 描画が 必要に なった ときです。 



WN / し PAINT メッ セージは、 ウインドウの 外 描 丨由丨 •が 必 •皮に なった ことを 知らせる ために、 
Windows から 送られます。 洱 描丨由 丨がゼ 、要になる ときとは、 ウィンドウを 開く とき や、 他の 
ウインドウの ドに なって 隠されて いた 部分が 以え るよう になった とき や、 アブリ ケー ショ 
ンの 中で Windows に 描 丨由丨 •を 要求した ときな どです 

Q 4 メッ セージと メッセージ ハンドラの 関係が よく わかりません。 

A 4 メッ セージに 対応す る メッセージ ハンドラは メッセージ マップで 定義され ています。 

すべての メッ セージには デフ ォルトの メッセージ ハンドラが フレームワーク によって ⑴ 
立され ています が、 メッセージ ハンドラは ブロ グラマが 丨’丨丨丨丨 に変史 （オーバー ライド） する 
ことができます。 しかし、 メッセージを 受け取って、 対応す る メッセージ ハンドラ を丨げ •び 川 
すのは フレームワークの 仆 ですから、 プログラマは メッセージ ハンドラの 変 セを フレー 
ム ワークに f ム •えなければ いけません 。ブロ グラマが メッセージ ハンドラの 変 セを フレーム 
ワークに fz ； •える ために 记義 する テーブルを メッセージ マップと 呼びます 
ClassWizard を 使っ て メッセージ ハンドラを 作成す る坳 介は、 ブロ グラマが メッセージ 
マッ プ をめ: 接編災 する 必要は ほとんどありません。 しかし、 残念ながら aassWizard が 
すべての メッ セージを 竹理 できる わけではありません し、 また 誤って メッセージ マップを 
壊して しまった ときな どのた めに も、 メッセージ マップの 惝 造を 知って おいた 力. が いいで 
しょろ。 

V- こじは CMainFrame クラスの メッセージ マップを 例に とって 説明し ます 以 ドは 
CMDIFrameWnd クラスを 店 成 クラスに 持つ CMainFrame クラスの メッセージ マップで 

す 。このように 、メッセージ マップは クラス ごとに 定戒 します 

BEGIN.MESSAGE.MAP (CMainFrame , CMDIFrameWnd) 

//{{AFX_MSG.MAP(CMainFrame) 

ON_WM_CREATE() // WM_CREATE メッセージを 処理す る 

//}>AFX_MSG.MAP 
END.MESSAGE.MAPO 



CMainFVame クラスが 独 『丨 に処 列! •をす るのは、 WM _ CREATE ： メッセージ だけです こ 
れをム している のが、 〇 N _ WM _ CREATE マクロです。 このように、 メッセージ 名の 前 
に 「 ON — 」 を； fi 加した 名前の マクロを 使って、 処神 する メッセージを 指 走し ます また 
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「WM_」 で 始まる メッセージに 対応す る メッセージ ハンドラの 名前は、 あらかじめ 決まっ て 
いて 変更す る ことは できません 。たとえば、 WM_CREATE メッセージ ならば、 OnCreate 
関数が メッセージ ハンドラと なります。 このように、 メッセージ 名から 「 WM -」 を 取り除 
き、 代わりに 「On」 を 付け加えた ものが メッセージ ハンドラの 名前と なって います。 

メッセージ マップに 新しい エントリを 追加したら、 忘れずに メンバ 間数の プロトタイプ 
宣言 もして おかなければ いけません 〇 フレームワークに とっては メッセージ ハンドラ とい 
う 特別な 間数で あっても、 コンパイラに とっては 通常の メンバ 間数と 変わらない のです 0 

class CMainFrame : public CMDIFrameWnd 
{ 

"•略 

// 生成した メッセージ マップ 間数 
protected: 

//{{AFX.MSG (CMainFrame) 

afx.mst? int OnCreate(LPCREATESTRUCT lpCreateStruct) ; 

//}}AFX„MSG 
DECLARE.MESS AGE.MAP ( ) 

}； 

WM_CREATE メッセージに 対応す る メンノ く IW 数の プロトタイプ 宵 言は、 「afx_msgint 
OnCreate(LPCREATESTRUCT lpCreateStruct):」 となります 。メッセージ ハンドラの 
リ丨 数と 返り 侦は表 4-1 にあげる ように、 メッセージ ハンドラ ごとに さまざま ですから 、党 
えきる ことは 亊实上 不丨丨 f 能と もい えます 。その 点、 ClassWizard を 使えば メッセージを 選 
ぶ だけで、 メッセージ マップ/メンバ 間数と しての プロトタイプ ai 丨 •メッセージ ハンド 

ラの 定義を すべて 自動的に 行って くれます 0 



メッセージ 


メッセージ マップ 


メッセージ ハンドラ 


WM.PAINT 


〇 N.WM_PAINT() 


void OnPaint() 


WM.LBUTTONDOWN 


ON.WM.LBUTTONDOWN() 


void OnLButtonDown(UINT nFlags, 

CPoint point) 

- ■■ — 


WM.CHAR 


ON.WM.CHARO 


void OnChar(UINT nChar, 
UINT nRepCnt, UINT nFlags) 



表 4-1 メッセージと メッセージ ハンドラの 対応 例 



Q5 メッセージ ハンドラが 終了した あとは、 どうなる のです か？ 

A5 いったん Windows に 理を 戻し、 また メッセージ ループを 繰り返します。 

メッセージ ハンドラを 作る ときに かならず 芩傲 しなければ ならない 重要な 指針が 1 つ あ 
ります。 それは、 「できるだけ 短い 時 問で 処理を 終 r させる」 という ことです。 仮にい っま 
でも 1 っの メッセージ ハンドラの 中で 処理を 絞け ている と、 次に やってきた メッセージは 





ークを 解剖して みよう 



処观 されず、 溜まっ ていく 一方に なって しまいます 。っまり、 ウィンド ウを勋 かそうと し 
たり、 キー 人力を しようと しても まったく 反応で きず、 ユーザーの II には あたかも ハング 
アップし たかの ように 兄え てし まう のです。 この ことは プログラミングを 行う 際には 常に 
Z メ U こ 切め て おくよう にして ください。 

メッ セージ ハンドラが 終 r すれば、 フレームワークが A 動的に 処理を windovvs に 炭し 

て くれます。 そして、 アプリケーション はまた 次の メッセージが; 丨丨 j くのを じっと 侍ち 続け 
るので す。 

Q6 いつ メッセージ ループは 終了す るので すか？ 

A6 WM_QUIT メッセージを 受け取った ときです。 

ウィンドウ イ丨丨 ••のく 閉じる〉 ボタンを クリックしたり 、タイトル バーの 左に ある アイコ 
ンを ダブル クリックしたり、 あるいは メニューから [ファイル] _ [終了] を选択 したりす 
ると、 さまざまな 経路を たど 丨） ますが、 似 終 的には WM_QUIT メッセージが ア プリ ケー 
シ ヨンに 送られます。 WM_QUIT メッセージは メッセージ ループで 特別な 扱いを されて ぃ 
て、 メツ セージ ハンドラは 呼び/ 丨丨 されず、 代わりに メッセージ ループを 終 で します。 続 ぃ 

て、 CWinApp::Runl»I 数、 WinMainlW 数と 順に 抜け出して、 设終 的に アプリケーション 
が 終 T します。 



4.3 プログラムの 丨荒れ 

反い 迫の りでした が、 やっと スケルトンに 追加した たった 】 行の コードに たどり 於く ま 
での 流れを つかむ ことができ ましたね。 ここでもう 一度、 He 丨丨 〇 企 休の 流れを 図 4 _ 2 に ま 
とめて みて みまし よう。 间の 左側が フレームワーク 内の 処理、 右側が Appwizard が 生成 
した コードと ブロ グラマが 記述した コードです。 

図 4-2 にボす Hello の樊 行の 手順の 中で とくに 注意して 欲しい のは 以下のような こと 
です。 

•アプリケーション クラスの オブジェクトの 定義 部 

CHelloApp クラスの 才 ブジェク トを定 在す る。 プログラマが 記述した コード 中で まっ 

たく 利⑴ していなくても、 フレームワークが 参照す るので、 かならず ！ つ宏義 して お 
くこと。 

• CWinApp::CWinApp 関数 

CHelloApp クラスの コンストラクタが 実行され る 前に、 その 接 成 クラスの コンスト ラ 
ク夕 か: 行され る。 この 屮 では、 丨: •に CWinApp クラスの メンバ 変数 や グローバル 必 




プログラムの 流れ 









数の 初期化が む われる 

• WinMain 関数 

グローバル オブジェクトの コンストラクタの 次に 呼び出される スタート アップ 
InitApplication 間数、 I 丨 litlnstance _ 数、 Run 閲 数を 順に 呼び出す 0 

• CHelloApp::lnitlnstance 関数 

インスタンス ごとに 必贤な 初期化 処 邵 （ドキュメント テンプレートの 众鉍 、フ 
ウインドウの 作成、 コマンド ラインの 解析 •など） が 行われる。 




Hello の 流れ 












• CWinApp::OnFileNew 関数 

図 4-2 には 示して いないが、 CHelloApp::InitInstance 関数から、 SDI アブリ ケー ショ 
ンの メインフレーム ウインドウを 作成す るた めに 呼び出される。 MDI アブリ ケー ショ 
ンの場 介は、 この |S{] 数を 呼 ひ 出す 前に、 CFrameWnd::LoadFrame 閲 数で 親 ウィンド 
ウを 作成して おぐ £、 要が ある。 

• CWinApp::Run 関数 

WinMainIKI 数から 呼び出され、 メッセージ ループを 実行す る。 以後 アプリケーション 

が 終/する まで、 Windows メッセージを 受信、 メッセージ ハンドラの 呼び出しを 繰り 
返す。 

• CMainFrame::OnCreate 関数 

C Win App::OnFileNew 閲 数で ウィンドウを 作成した ときに 発行され た WM_CRE 

ATE メッ セージを フレームワークが 受け取り、 この メンバ _ 数が 呼び出される。 この 
ように、 メッセージを 介して 処理を 行う 場合には、 すぐに 処理され るとは 限らない。 
なぜなら、 CWinApp::OnFileNew 閲 数を ' 戈 行した 時/ •(では、 まだ メッセージ ループが 
始まって いないから である。 

• CView::OnPaint 関数 

ウインドウが 作成され ると、 まず WM—PAINT メッセージが Windows から 送られて 
くる。 この メッセージを 受け取った フレームワークは、 対応す る メッセージ ハンドラ、 
OnPaint 閲 数を 呼び 川す。 灾肪 には CView :: OnPaint 閲 数が 呼び出される 0 

• CHelloView::OnDraw 関数 

CView::OnPaint 閲 数は、 OnDraw 閲 数を 呼び出す ようになって いる。 しかし、 cView:: 
OnDraw 仮想 ISJJ 数は 純粋 仮想 IW 数で あるた め、 実際には CHelloView::OnDraw 丨 W 数 
が 呼び出され、 丨_丨 面に** Hello World!” と 表示を 行う。 



第 2 部 

Visual C ++ プログラミング 

の 基本を 押さえよう 



第 1 部では 、 Visual C ++ のプ □グラムが どのよう 
に 組み立てられ ていく のか、 その 基本と もい うべき 部 
分を 紹介し ました。 こうして 第一歩を 踏み出 したあな 
たの 前には、 広大な Windows プログラミングの 世界 
が 待ち受けて います。 しかし 、 Visual C + + を 使って 
本格的な 仕爭を 始める には、 まだまだ 準備が 足 0 ませ 
ん 。とくに 今の あなたに 欠けて いると 思われる のは、 
Windows 特有の グラフィカルな® 境で データ 入出力 
を 行うた めの 知識です。 そこで この 第 2 部では 、 GDI 
を 使つ た データ 出力と、 メニューと ダイアログ ボック 
スを 利用した データ 入力、 さらに キーボードと マウス 
からの データ 入力を 中心に Windows の ユーザー イン 
ターフェ イスに ついて 解説し ます。 さらに リソース エ 
デ ィタと ClassWizard の 詳しい 使い方 も 覚えて もら 
います。 そして、 S 後に プログラムを 作成す る 上で 欠 
かせない こと 一 すなわち、 デバッグ 一 についても 
解説を する ことにしましょう。 ここで 述べられる 悄報 
は、 し、 わ ば Windows プログラミングを マスター する 
ための 基礎 体力に 相当し ます。 しっかり 身に 付ければ、 
Visual C + + を 征服す るた めの 大きな 力と なって くれ 
る ことでしょう。 



GDI は 

グラフィックス 表示の 合言葉 



MS - DOS と Windows の幽丨 fti を 比較した とき、 丨 山丨荇 の もっとも 人き な 相違 成は 何でし ょ 
う？ 冬え るまで もな く、 矜は 解像度の 递 いです。 かた や 80 义 卞>< 25 行 秤 度の テキスト 丨 丨丨丨 i 
Ifli 、 かた や ili •低で も 640 ドット X 480 ドットの 広 人な グラフィックス iWlftl •が 相手です 〇 丨 由 ilfli 
に 表 >ji される 絵 や 文字の 細か さ、 笑し さは、 どうしても Windows に袱 ft ! が丨 ••がります。 

もちろん MS - DOS の アプリケーション でも 独 H に グラフ ィッ クスを 扱う ものは ありま 
すが、 Windows は OS H 体が グラフィックス 処理 機能を 装備して いる ことが 人き な 強みで 
す。 ブロ グラマは Windows の 持つ 機能を 利用で きる ため、 丨 (丨丨 倒な 作 菜は ほとんど 必要な 
く、 わずかな 労力で、 Windows 特 イ! •の グラフィカルな ユーザー インターフェイスが 泼现で 
きる のです。 

Windows が⑴总 した、 グラフィックス データを 扱うた めの 統 •インターフェイスには、 
GDI (Graphics Device Interface) という 名前が 付けられて います。 GDI は、 その 名のと 
おり 丨由 i ifn •だけでは なく、 プリンタ 出力な どを 穴む 広範 I 用の グラフィックス デバイス 操作 ルー 
チンの 染介 体です が、 この タ では デ ィス ブレイ 丨由 itfn の 扱いに 詁を 吸定 して、 GDI の 基本 操 
作を 学ぶ ことにします。 

1.1 デバイス コンテ キス 卜と CDC クラス 

GDI という 統 •インターフェイスの 中心的 你丫 i : が デバイス コンテ キス 卜です。 デバイス 
コンテキストは、 しばしば DC とも 略されます 0 

デバイス コンテキストは、 いろいろな 楝 類の グラフィックス 衣， デバイスを 抽象化し たも 
のです 。抽象化と いう 言 使が わかりにくければ、 ハードウェアの 恙與を 吸収す る クッシ ョ 
ンと でもい いまし ょうか。 



GDI は グラフィックス 表示の 合言葉 

たとえば MS-DOS では、 CON ファイルに デ 一夕を 丨丨! : き 込む ことで、 データの 丨 由丨而 出力 
が 町 能な ことを ご存じ かと 思います。 これが できる のは、 I 由 丨咖 •と ディスクの ように、 ノ 、一 
ドウ ェアは W •なっても 、「ファイル」 という 名前の もとに 丨叫 荇を 統一的に 扱える ように、 
MS-DOS の 中で ソフトウェア 的な クッションが 設けられて いるから です。 

デバイス コンテキスト にも、 これと |„j じような 总味 介い があります。 Windows では、 グ 
ラフ ィッ クス データの 川ノ j 光は 丨丨丨 丨丨丨 〖丨丨 や プリンタ などの パ •体 的な ハードウェアで はなく、 常に 
デバイス コンテキストです 0 灾陬 には それは 丨山丨 •丨 〖丨丨 | ••の ウィンドウを 总味 する かもしれ ない 
し、 プリンタ かも、 あるいは メモリ 内の バッファ 領域 かもしれ ません。 しかし データを 川 
ノ J する 側は、 そんな ことは シ: にせず、 いつでも デバイス コンテキストに 対して データを 川 
力 すれば よいので す 。つまり、 デバイス コンテキストを 利) |j する ことによって、 Windows 
では、 デバイスに 依# せずに グラフィックスを 出ノ j できるようになる のです。 

參 デバイス コンテキストの 取得と 解放 

デバイス コンテ キス 卜の 寓休 は、 肉 •丨 〖丨丨 •の サイズ や 描丨叫 モードの •没定 など、 火 際の デ バイ 
スの# 作を 決める データの 災 まりです。 Visual C+ + では、 CDC クラス （デバイス コンテ 
キス トクラス） を 使って デバイス コンテキストを 衣します。 

Windows の プログラムで 何ら かの データ （丨丨 力を 行う には、 まず 出力 対象の デバイス コ 
ン テキス 卜を 取怍 し、 次に その デバイス コンテキスト に対して CDC クラスの メンバ 問 数 
を 火 行 するとい う r •順を 跆 みます （コラム 参照 >〇 たとえば クライ アン 卜箾 域に 义 や 丨ズ丨 形 
を炎尔 する 垛介 も、 とにかく W ： 初に その デバイス コンテキストを 佾 なければ なりません n 
そこで 利 相され るの が、 CWnd::GetDCWJ 数と、 CWnd::Re 丨 easeDC 関数の 2 つです。 

CWnd::GetI)CIW 数は、 指记 した ウィンドウの クライアント 領域の デバイス コンテ キス 
卜を 収得し ます。 また、 この 明 数で 得た デバイス コンテキストは 使い 終えた 時点で 解放す 
る 必要が あります が、 それを 行う のが CWnd::ReleaseDC 関数です。 

以 ドに 小す プログラムは、 CMyVievv •という ビュー クラスが ある ものと して、 その クラ 

イアン ト 領域に“ He 丨丨 〇 World! " と 衣 小す る、 CMyView::ShowHello 関数です 0 

void CMyView: :ShowHello() 

{ 

CDO pDC; 

pDC = GetDCO; //pDC = this->GetDC〇; と 同等 （コラム 参照） 

pDC->Text0ut(0, 0, "Hello World!"); 

ReleaseDC(pDC) ; "this->ReleaseDC(); と 同等 （ク） 
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メンバ 関数の 呼び出し 

メンバ 関数は、 特定の クラスの オブジェ ク 卜を 操作す るた めに 定義され た 関数で、 C 言語 
には 存在し なかった 概念です。 たとえば 本文 中に 登場した GetDC 関数と ReleaseDC 関数 
がそう です。 メンバ 関数を 実行す る 場合は、 原則として、 操作の 対象と なる 才 ブジェク 卜 か、 
才 ブジェク 卜への ポインタを 指定し なければ いけません。 オブジェ ク卜 そのものを 対象と す 
る 場合は、 クラス オブジェ ク卜 選択子 「.」 を、 オブジェ ク 卜への ポインタを 指定す る 場合は、 
クラス ポインタ 選択子 「->」 を 使います。 

// オブジェクトを 指定す る 

CDC* pDC ; 

CWnd Wnd ; 

pDC = Wnd.GetDCO; //Wnd を 対象と して GetDC 間数を 実行す る 

"才 ブジェク 卜への ポインタを 指定す る 

CDC* pDC ; 

CWnd* pWnd; 

pDC = pWnd->GetDC(); // pWnd の 指す オブジェクトを 対象に GetDC 間数を 実行 

メンバ 関数の 中では 「その メンバ 関数の 操作 対象と なって いる オブジェ ク 卜」 を this という 
ポインタが 指して います。 よって CWnd クラス （または CWnd クラスの 派生 クラス） のメン 
バ 関数の 中では、 次のように this を 介して GetDC 関数を 実行で きます。 この場合 「 this ->」 
は 省略で きます。 

void CWnd::Foo() //CWnd クラスの メンバ 間数 Foo の 定義 

{ 

CDC* pDC ; 

pDC = this->GetDC(); // Foo 関数の 対象の 才 ブジェク 卜の GetDC 閣 数を 実行 
pDC = GetDCO; //pDC = this->GetDC(>: と 同等で ある 



さらに 詳しい ことにつ いては 、 Appendix A を 参照して くださし、。 



♦ OnDraw 関数の 引数と して 渡される デバイス コンテ キス 卜 

デバイス コンテキストは、 フレームワークの 屮で rj 動的に 取得され る 場合 もあります c 
たとえば 第 1 部の Hello プロジェクトで 作成した OnDraw 間数の 定義を 见て みまし よう。 

void CHelloView: :OnDraw(CDC* pDC) 

{ 

pDO>Text0ut(0, 0, "Hello World!"); 
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この OnDraw 問 数では、 わざわざ 「丨 分で デバイス コンテキストを 取得す る 必要は ありま 
せん。 リ丨 数の pDC に対して デ一夕を 出力 すれば、 その 結果と して 11111 •血に 文字が 表示され る 
のです 。これは、 フレーム ワークの 中で デバイス コンテキストが 取得され、 それが 0nDraw 
聞 数に リ丨数 pDC として 渡されて いるから です。 

デバイス コンテキストの 取 沿に 問して 〇 n D raw 関数が このような 特別な 立場を とってい 
る ことには？ P •山が あります 0 OnDraw 関数は 実は 園 丨财 出力 だけでは なく、 ブリン 夕 出力の 
際に も 利 川され る 関数 だからです 。つまり OnDraw 問 数が デバイス コンテキストを リ丨 数と 
している のは、 || 丨丨 j|〖U •出力 時には 丨叫丨(丨丨のデバイスコンテキスト、ブリンタ川カの場合はプリ 
ン 夕の デバイス コンテキストが 指 走で きる ようにす るた めな のです。 

まあ 押 •山は ともあれ、 今のところは 「OnDraw 間数の 中では GetDC 閲 数 や ReleaseDC 
問 数を 火 行す る必贤 はない」 という ことを 觉え ておいて ください。 

•文字列 表示の ■本 操作 

ここで デバイス コンテキストに 文字列を 表示す る 族 + 操作、 つまり CDC クラスの メンバ 

関数を まとめて おき ましょう 3 W： 初に あげられ るのは、 すでに おなじみの CDC::Text()ut 

IW 数です 。この間 数は、 文字を 表ボ する 位 脫、 衣 ホしたい 文字列、 そして 文字列の 長さを 
リ丨 数と します。 

char *strl = "Hello No.l"; 

pDC->TextOut(x, y, strl ， strlen(strl)); // 座摞 （ x.y> に ” HelloNo.l " を 表示 

リ丨 数に CString クラスの 才 ブジェク 卜を 指定す る こと もで きます， この場合は 义卞 列の 
从 さを 指定す る必 贤 はありません。 CString クラスとは、 义す •列を 操作す るた めに MFC 
が川总 した クラスで BASIC 言語 的な 文字列 操作 （Mid 閲 数， Left 間数/ Right 関数な ど) 
が 町 能な 便利な クラスです。 

CString str2( M Hello No. 2"); 

pDC->TextOut(x, y, str2) ; // 座棵 （ x.y) に - Hello No.2 ” を 表示 

また 文卞 列逛 数を 指定す る 場合 も、 やはり 於 さの 指定は 必要ありません。 
pDC->TextOut(x, y, "Hello No. 3"); // 座摞 （ x.y> に -Hello No.3 ” を 表示 

义卞の 色を 変える には CDC::SetTextColor 間数、 文字の すきまから U える*/ f 以 の 衣/ j; •力 • 
法を 変える には CDC::SetBkMode 関数と CDC::SetBkColor 関数を 利用し ます。 初期設定 
は、 文字 色が 患、 背说は 不透明、 背说 色は 由です。 

pDC->SetTextColor(RGB(0， 0， 255)); // 文字の 色を 青に S 定 する 
pDC->SetBkMode (TRANSPARENT) ; // 文字の 背景を 透明に する 

pDC->SetBkMode (OPAQUE) ; // 文字の 背景を 不透明に する 

pDC->SetBkColor(RGB(255, 0, 0)); // 文字の 背景 色を 赤に 設定す る 
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liW 面に 数値な どを 表示す るには、 いったん 文字列 化してから CDC::TextOut 関数で 出力 
します。 数値の 文字列 化には Windows API として 提供され ている wsprintf 関数を 利用す 
ると よいで しょう。 この 関数は C H 語の 標中 ライブラリの sprintf 関数と 同じ 機能を 持ち 
ますが、 Windows カーネル 内に DLL として 用意され ている ため、 いろいろな 点で イ 丨 •利に 
なって います。 wsprintf 関数の 利用 例を 次に 示します。 

char buf [20] ; 
int x = 2; 
int y = 3; 

wsprintf (buf , " C/.d,7.d) " , x, y); // •• (2. 3) ” という 文字列を 作成 

pDC->TextOut(x, y, buf, strlen(buf ) ) ; // 座摞 （ 2. 3) に •‘ （ 2. 3 ) " と 表示 

•グラフィックス 表示の 基本 操作 

グラフ ィッ クスの 炎 小 方法 も 店 本 的には 文す •列 衣 示と まったく 丨 „•] じで、 デバイス コンテ 
キス 卜を 対象と して、 グラフィック 描丨丨 丨丨丨 •川 メンバ 閲 数を 火 行す る だけです 。たとえば 点を 
衣ボ する には 次に 示す CDC::SetPixe 丨閲 数を 使用し ます。 

pDC->SetPixel(x, y, RGB(255, 0, 0)); //(x,y) に 赤の 点を fj つ 

SetPixe 丨閲 数は、 指 走した 啤檔 に、 指定した 色で、 点を 衣 示します 。このと き デフ 才ル 

卜の 設定では 、ビュー ウィンドウの 左上 隅を （〇•〇) とする ビクセル 中. 位の 蜞標 系が 使われ 
ます* 1 。 

CDC::SetPixe 丨閲 数の 第 3 リ丨 数は、 描 丨由丨 •色を 指定す る COLORREF 咽の 数侦 です。 Wind 
ows で 色の 指定を する 坳介 は、 かならず この データ 喂を 指定し ます。 COLOKREF 喂の数 
侦を 得る には、 RGB マクロを 利 川して 赤、 鉍 、奇の 色 成分を 指定す るか、 または windows 
API の GetSysColorlKI 数に よって Windows の システム カラーを 得る のが 簡中 •です。 RGB 

マクロの J I •体 的な 利 IH 方法は この あとで 説明し ます。 

1**( 線を リ丨 くには、 CDC::MoveTo 間数と CDC::LineTo|iiI 数を 組み合わせて 使⑴ します。 

pDC->MoveTo(x, y); //(x.y ) を 線の 始点 とする 

pDC->LineTo(x, y); //(x, y ) まで 線を 引く 

まず MoveTo 閲数 によって 始点 の位时 を 決め、 次に LineTo 関 数で 終戍を 指 记 すると、 

2 点 問に 線が' j | かれます （ただし 終点は 丨 白: 線 内に 含まれません）。 LineT〇 間数を 続けて 实 
むし、 迚続 した 祈れ 線を 描いて いくこと もで きます。 

ところで、 CDCiineTo 閲 数には、 CDC::SetPixel 関数と 違って if (線の 色を 指 走す るリ | 
数が ありません 0 •股に Windows ブロ グラムで 線の 色を 変える には、 「ペン」 という GDI 



* 1 CDC :: Set \ lapMode 閲敌を 利 川 すれば 他の 崢標系 も指记 iif 能 だが、 本 
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才 ブジェク 卜を 使用す るからで す。 GDI オブジェクトとは 何 か？ その 答は、 この あとす 
ぐに …… 



1_2 GDI 才 ブジェク 卜 

— ベンと ブラシと ビッ卜 マップ 

グラフ イッ ク 処理は、 どんなに 複雑に u えても、 結 屈は いくつかの 浓本 操作を 組み合わ 
せた ものにす ぎません 。そこで Windows では、 デバイス コンテキスト に対して 行う 操作 
を 何 神: 類 かに 人別し、 それぞれを 処理す るた めの V/ 州の 「逍 HJ を 用意し ました 0 この 「迫 
具」 を 総称して GD 丨オ ブジェク 卜と 呼びます。 

この 职 では、 ペン、 ブラシ、 ビットマップ という 3 神: 類の GDI オブジェクトの 使い方を 
兄て いきまし よう 。これらは 表 1-1 のよう な 操作に 対応して います。 



GDI オブジェクト 


操作 


ペン 


線を 引く 


ブラシ 


面を 逢る 


ビットマップ 


図形を 表示す る 



表 1-1 GDI オブジェクトの 種類 



GDI 才ブジ ヱ クトは 図 1-1 にボす MFC の クラスを 介して 操作され ます 。たとえば、 ぺ 
ン 、ブラシ、 ビットマップに 対しては、 それぞれ CPen、 CBrush、 CBitmap という クラス 
が 用意され ています 。また 本许 では 扱いません が、 このほかに CFont (フォント）、 CPalette 




図 1-1 GD 丨才 ブジェク 卜を 管理す る クラス 





1.2 GDI 才 ブジェク 卜一 ベンと ブラシと ビットマップ 



(パ レッ 卜）、 CKgn (リージ ョン） という 3 つの クラスが あります 3 これらの クラスは すべ 
て、 CGdiObject クラスの 派 少 クラスと して 定 在され ています。 

ここで、 GDI 才 ブジェク 卜は、 C+ + I 丨 •語で いうと ころの 「クラスの オブジェクト」 とは 
別 もの だとい うこと に してく ださい。 

たとえば CPen クラスの オブジェクト といった 場合、 これは 「ペンの GDI オブジェクト」 
ではなく、 あくまでも rCPen という クラスの オブジェクト」 です > 火 際の GDI 才 ブジェク 
卜は、 CPen クラスの オブジェクトが 竹 J*|! している データの 1 つに すぎない のです。 

そもそも C + + i? 通と Windows が M じ オブジェクト という 川 語を 使って しまったの が 
浞乩の もとです が、 いまさら 変 Oi する こと もで きません 。以 卜の (では 「CPen クラスの 才 
ブジェク 卜」、 「ペンの GDI 才 ブジェク 卜」 という J 丨 、•介に いい ノアを 変え、 できるだけ 丨メ: 別が 
つくよう 努力して みました。 

籲 ペンの 利用 法 線の 描画 スタイルを 指定す る 

ペンは 線の 色 や 形状を 指定し ます。# •滞 •に丨 |1 純な GDI オブジェクトで すが、 以 ドに 述べ 
る ペンの 使い かの 屮 には、 （;1)1 才 ブジェク 卜 利 川の ための ェッセンスが すべて 穴 まれて い 
ます。 まずは ここで （;1)1 オブジェクトの 操作の 丛 本を 觉え ましょう。 

G1 プ ロジェ ク 卜の 設計 

それでは、 ペンの GDI 才 ブジェク 卜の 火 除を W •て 行く 丨 W に、 テスト プログラムを, k! 述す 
るた めの プロジェクトを 作成して おきましょう 3 以 ドは AppWizard と、 その オプション 
で 沿め る アプリケーションの 拃糾 みです。 

•プロジェクト 名： G1 
* アプリケーションの タイプ： SDI 
春 データベースの サポート： しない 
鲁複介 ドキュメントの サポート： しない 
♦ツール バー ステータス バー： なし 
♦印刷と 印刷 プレビュー： なし 
春 そのほか： デフ ォル 卜の まま 

I ••の ガ 針に 従って、 AppWizard で プロジェクトを 新規に 開始して ください。 また、 この 
プロジェクトは 丨 I 丨丨 丨丨 〖丨丨 描 丨由 | の テス 卜の ための ものです から、 ここで 必要になる 関数は 第 1 部 
でも お世話になった ビュー クラスの OnDraw 間数です。 この プロジェクトでは、 針 5 つの 
テストを します から、 PenTestl 〜 PenTest5 までの 5 つの 関数を OnDraw 間数の 中から 
呼び出す ことになります 3 そこで、 GlView.cpp の リス 卜 1-1 に 示した 部分を リス 卜 1-2 
のように 修正して おいてく ださい 。これからは、 PenTest 1 〜 PenTest5 までの 関数の 灾装 
をしながら、 ペンの 利 丨丨丨 方法を 学んで いくこと にしましょう。 
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リスト 1-1 変更 前の リス 卜 （GIView.cpp) 

1111111111111111111111111111111111111111 

//// CGIView クラスの 描画 

void CGIView: :OnDraw(CDC* pDC) 

{ 

CGIDoc* pDoc = GetDocument () ; 

// TODO: この 壜 所に ネイティブ データ 用の 描画 コードを 追加し ます。 



リス 卜 1-2 変更 後の リスト （GIView.cpp) 

1111111111111111111111111111111111111111 
//// CGIView クラスの 描画 
void PenTestl(CDC* pDC) 

{ 

> 

void PenTest2(CDC» pDC) 

{ 

} 

void PenTest3(CDC* pDC) 

{ 

> 

void PenTest4(CDC* pDC) 

{ 

> 

void PenTest5(CDC* pDC) 



void CGIView: :OnDraw(CDC* pDC) 



pDC->TextOut ( 16 , 
DC->TextO * 
DC->TextO 
pDC->TextO 
pDC->TextO 



10, "TEST 1") 




PenTestl(pDC) 

PenTest2(pDC) 

PenTest3(pDC) 

PenTest4(pDC) 

PenTest5(pDC) 
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ベンの 作成 

ペンを 利用す る 場合には、 最初に CPen クラスの オブジェクトを 定義し ます 〇 CPen は 
その 名前が 示す とおり、 ペンを 扱うた めの クラスです 0 

CPen myPen ; 

この 定義の 段階では、 まだ myPen に 対応す る ペンの GDI オブジェクトは 存在して いま 
せん 。ペンの GDI オブジェクトを 作成す るには、 CPerrCreatePen 関数を 実行し ます。 

myPen. CreatePen(PS_SOLID, 1, RGB(255, 0, 0)); 

この結果、 Windows の システム メモリ （GDI リソース 領域） 内に ペンが 作成され、 myPen 
と 結び付けられます。 CPen コ CreatePen 問 数の 引数の: 味は 次瑣で 説明し ますが、 とりあ 
えず 上の 例では、 実線、 太 さ 1、 赤色の ペンを 指定して いるものと 理解して ください 0 

さて、 個々 の デバイス コンテキストには、 常に 1 本の ペンが 割り当てられ ています 。初 
期, 15 定は太 さ 1 の 熏 い 実線です 。これを myPen に 交換す ると、 以後 その デバイス コンテ 
キ ストに 引く 線は、 すべて myPen を 用いて 描かれる ことになります 0 

デバイス コンテキストの ペンを 交換す るには、 次のように CDC :: SelectObject 関数を 使 
用し ます 。ここで pDC は 目的の デバイス コンテキストへの ボ インタです。 

CPen* pOldPen; 

pOldPen = pDC->SelectObject(&myPen) ; 

このと き、 CDC::SelectObject 閲 数は、 それまで デバイス コンテキストに 割り当てられ 
ていた ペンへの ポインタを 返します 。ペンを 使い 終わった らもとの 状態に 戻す 必要が ある 
ので、 戻り 値は 上記の ように かならず 記録して おいてく ださい。 

これで 準備は 完了です 。以後 デバイス コンテキスト pDC に対して 引く 線は、 myPen で 
指定した 「太 さ 1 の 赤い 実線」 になります 。あとは、 三角 閲 数の グラフで も、 エッチな 絵で 
も、 お望みの ままに 描けます。 

描 _ を 終えて 用済みに なった ペンは 削除し なければ なりません。 この 作業を 忘れて ペン 
の 作成を 繰り返す と、 Windows の GDI リソース 領域が 次第に 食いつ ぶされ ていって しま 
います。 ペン 削除の 手順は 以下のと おりです。 

まず myPen を デバイス コンテキストから 切り離す ため、 再び CD し SelectObject 関数 
を 実行して、 さきほど 記録して おいた pOldPen と myPen を 交換し ます 。この 操作の 目的 
は、 あくまでも デバイス コンテキストから myPen を 解放す る ことです。 結果 としてもと 
の ペンが 復活す るのは、 準なる 才マケ にすぎないと 思っても よいく らいです。 

pDC->SelectObiect (pOldPen) ; // (a) 
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ペンを 削除す る 際には、 その 前に デバイス コンテキストから 切り離す ことを 決して 忘れ 
ないで ください 。この 作 菜を 怠る と、 Windows の 動作に 深刻な 恶影哪 を 及ぼします。 

次に、 こうして myPen が デバイス コンテキストから 「|山 になった ところで、 myPen が 
ff 坪して いた ペンの GDI 才 ブジェク 卜を システム メモリから 消 太 •します。 

myPen.DeleteObjectO ; //(b) 

I ••の （ a) と （ b 丨 は、 pI)C->SelectObject ( pOldPen) が myPen への ポインタを 返す こと 
を 利 叩して、 次のように 1 行に まとめて •》!: くこと も" J* 能です 0 しかし プログラムが 説み に 
くくなる ので、 あまり お 肋め はしません。 



(pDC->Select0bject(p01dPen))->Delete0bject() ; 



以丨 •.の; N ((で ペンを 作成し、 クライ アン 卜 領域に 線を リ | く 火 例が、 G1 プロジェクトの 
GlView.cpp に 含まれる PenTestl 問 数です 。リス 卜 1-3 にこの 問 数の コ一 ドを 示します 0 
PenTestl 閲 数は OnDrawKI 数から 呼び 丨丨丨 されます 〇 このと き 引数 pDC に クライ アン 

卜 領域の デバイス コンテキストへの ポインタを 渡して います。 

リス 卜 1-3 ベンの 作成と 利用の テス 卜： PenTestl M 数 （ G1 View.cpp) 

void PenTestl(CDC* pDC) // CreatePen 間数で ペンを 作る 方法 

{ 

CPen myPen; 

CPen* pOldPen; 

myPen.CreatePen(PS-SOLID, 1 ， RGB(255, 0, 0)); // ペンを 作成 
pOldPen = pDC->SelectObject(&myPen) ; //1M 択 

pDC->MoveTo(10, 20); // 線を 引く 

pDC->LineTo(210, 20); 

pDC->Select0bject(p01dPen) ; // iM 択 終了 

myPen.DeleteObjectO ; // ペンを 削除 



さきほどの 乍の PenTest 1 閲 数に この コードを 記述して、 ブロ グラムを コンパイル/ 灾 
行す ると、 丨由丨 面の M •上部に 水、 P の 赤い 丨 &: 線が 引かれる ことを 確かめて ください （図 1-2)。 




図 1-2 PenTestl の 実行 結果 

ベンの スタイル、 太 さ、 色 

CPen :: CreatePen_ 数の 引数は、 図 1-3 のように、 作成す る ペンの スタイル、 太 さ、 お 
よび 色を 指定し ます。 

CreatePen(int nPenStyle, int n Width, COLORREF crColor); 

ベンの スタイル ベンの 太 さ ベンの 色 




図 1-3 ベンの 厲 性の 指定 

第 1 引数には 表 1 -2 に 示す スタイルを 指定し ます。 ここで PS_NULL と PS—INSIDE 
FRAME の 2 つは、.: R に M 方形 や 格 円な どの 枠と して 利 川す る ペン スタイルです 0 
PS_SOLID スタイルと PSJNSIDEFRAME スタイルでは、 CPen::CreatePen 閲 数の 第 
2 リ丨 数に よって 線の 太 さを 指定で きます 。そのほかの ペン スタイルでは 1 以外の 太 さは 選べ 
ません （点線 タイプの ペンに 1 以外の 太 さを 指 走す ると、 強制的に 突 線に 変! ii されます ）〇 
CPen ン CreatePen 問 数の 第 3 引数は ペンの 色を 指定し ます。 Windows プログラムでは、 
すべての 色悄 報を 図 1 -4 のよう な 24 ビットの 論理 カラー （COLORREF 戢 データ） で 衣し 
ます。 rgb の 各 成分は、 それぞれ 8 ビットの 範拥の 整数 値 （0 〜 255) です 0 
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ペン スタイル 


線の 形状 


太 さ 指定 


論理 カラー 変換 法 


PS.SOLID 


実線 


[。可能 


純 色 化 


PS.DOT 


短い 破線 


X 不可 


純 色 化 


PS.DASH 


長い 破線 


X 不可 


純 色 化 


PS.DASHDOT 


1 点销線 

^ 


X 不可 


純 色 化 _ 


PS.DASHDOTDOT 


2 点 鎖 線 

~ - 


X 不可 


純 色 化 


PS_NULL 


透明 


X 不可 


純 色 化 


PS.INSIDEFRAME 


実線 (枠の 境界 内に 収まる） : 


G 可能 


ディ ザ リング [ 



注： PSJNSIDEFRAME スタイル でも ペンの 太 さが 1 の 場合は 純 色 化される 



表 1-2 ベン スタイル 

ビット 番号 g 1615 8 7 〇 

赤 （ R ) 緑 （ G ) 青 （ B ) 

I 

h — 8 ヒッ卜 — 8 ビッ卜 —— — 8 ビッ卜 —— ►! 

図 1-4 搞理 カラー （ COLORREF 型 データ） 

RGB ( r . g . b ) という マクロを 使う と、 rgb 成分に よって, 金 押 •カラーが 指定で きます。 た 
とえば RGB (255.0.0) は、 亦 成分 255、 緑 成分 0、 が 成分 0 ですから、 純粋な 赤と いう こ 

とになります。 

論 观 カラーは 令 体で 2 の 24 乘 《約 1670 乃 •） 色が 衣现町 能です が、 ハー ドウ ヱアの 制限 

で それほど 多くの 色を m せない 場 •介は、 欠 際の 衣ボの 際に 論那 カラーを 適、 丨彳な 色に 変換し 

ます。 変換 ノ / 法には 次の 2 神: 類が あり、 Windows は 状況によって W •者を 使い分けます （表 
1-3)。 



変換 方法 


論理 カラーと 実際の 表示 色の 対応 


純 色 化 


その ハー ドウ ヱァで 表示 可能な 色 （純 色） の 中で、 指定した 論理 
カラーに もっとも 近い ものを 選ぶ 


ディ ザ リング 


異なる 色の 点を 交互に 配 匱して 色を 混ぜ、 指定した 論理 カラー 
を 擬似 的に 作り出す 



表 1-3 色 変換の 方法 



ペンに よる 線の 描 肉の 際は、 地 + 的には 純 色 化に よって、 論 列!. カラーから 火 際の 衣： 色 

への 変換が 行われます 。ただし PS — INSIDEFRAME スタイルで 1 以外の 太 さを 指定した 

場合には、 デイ ザ リングが 川 いられます。 





1.2 GDI 才 ブジェク! ペンと ブラシと ビットマップ 



コン ス卜ラ クタと デス 卜 ラ クタの 利用 

コンスト ラク 夕は、 クラスの オブジェクトを 定義した ときに、 かならず 呼び出される 間 
数で、 この 中で クラスの メンバの 初期化な どの 作 袋を むいます。 コンスト ラク 夕は クラス 
と M じ 名前の メンバ 閲数 として 记 義 され、 たとえば CPen クラスの コンストラクタの 名前 
は CPen::CPen () となります。 

CPen クラスには、 次の 2 M 頌の コンストラクタが ⑴ されて います。 C+ 訪 では、 
リ丨 数の 並 •びが 迫う 場合には M 名の 関数を 複数 定義す る ことが nf 能で あり、 これを 関数の オー 
バー ロードと 呼びます が （詳細は Appendix A を 参照）、 CPen クラスでは 関数の オーバー 
ロードを 利 川して、 以 ドの 2 つの コンストラクタを 從 供して いるので す。 

CPen: :CPen() ; 

CPen: :CPen(int PenStyle, int PenWidth, COLORREF color); 

引数を 持たない 1 つ 丨丨 の コンストラクタは、 丨 I 1 •に CPen クラスの オブジェクトを 作成す 

る だけで、 明示的に CPen::CreatePen 関数を 炎 行 しないと ペンの GDI オブジェクトは 作成 

されません 。それに 対して リ丨 数を 持つ 2 つ 1丨 の コンスト ラク 夕は、 CPen クラスの オブジェ 
クトを 確保した 丨 ••に、 ペンの GDI 才 ブジェク 卜の 作成まで 行うよう に 走 衣され ています。 

たとえば 前項の ブロ グラムでは、 次のように リ丨 数を 指定せ ずに myPen を 定義し ました 0 
この 坳介 はリ丨 数を 持たない コンストラクタが 使 川され ます。 

CPen myPen ; // 引数を 持たない コンストラクタが 起動 

しかし my Pc、n を记義 する 際に 次のように 引数を 指定す ると、 リ丨 数を 持つ コンスト ラク 
夕が 使 川され、 CPen クラスの 才 ブジェク 卜の 確保と 時に ペンの GI)I オブジェクトを 作 
成す る ことができます 0 

CPen myPen (PS__S0LID, 1, RGB (0, 0, 255)); // 引数を 持つ コンストラクタが 起動 

つまり これは、 以 ドの: T •順によ る my Pen の 作成と 丨 じこと です。 

CPen myPen ; 

myPen. CreatePen(PS.SOLID, 1, RGB(0, 0, 255)); 

コンストラクタが 才 ブジェク 卜 作成 丨ほに 炎 行され るのに 対し、 オブジェクトが 解放され 
ると きに かならず 火 行され る 問 数が デス 卜 ラ クタです 0 デス トラクタは クラス 名の 先頒に 
「一」 （チルダ） を 付けた 名前の メンバ 問 数と して 定義され 、オブジェクトの 解放に 伴う さま 
ざまな 後始 七を 行います 。たとえば CPen クラスの デス トラクタ CPenrCPenlSl] 数には、 
H 動的 (こ ペンの GDI 才ブ ジヱク 卜を 削除す る 機能が ひえられ ています 






この PenTest2 間数と、 さきほどの PenTestl 間数を 比べて みて ください。 どちらも ほ 
とん ど M じ 作 菜を している のです が、 リ丨数 付きの コンストラクタ や デス トラクタに ペンの 

作成と 削除を まかせた おかげで、 PenTest2 間数は ブロ グラムが PenTestl 閲 数よりも すっ 

きりした ものと なって います。 

という わけで、 引数を 取る コンストラクタを 使う と、 タイ ビングの 手 問は 竹け るし ブロ 
グラムの WJifi しもよくな るし、 こんな 結構な ものはありません 。とくに、 p en T es t2 関数 
のように 問 数の 入 丨 丨 で定喂 の ペンを 作成し、 閲 数の 出 丨丨で それを 削除す ると いった 形式の 
ブロ グラムでは、 祯極 的に 利 川す るべき です。 

ただし、 いつでも コンスト ラク 夕に 頼って いればよ いかと いうと、 そう もい きません。 

PenTest3 間数を E てくだ さい （リス 卜 1-5>〇 

リスト 1-5 明示的に CreatePen 関数を 実行した 方が よし 湖 合： p e nTest3 M 致 （G1 View.cpp) 

void PenTest3(CDC* pDC) // だからって コンストラクタ だけ 覚えても だめ 

{ 

CPen myPen ; 

CPen* pOldPen; 



COLORREF cr; 



GD 丨オ ブジェク 卜 一 ペンと ブラシと ビッ 



for (i = 0; i < 30; i++) { 

cr = RGB(rand() •/• 256, randO •/• 256, rand() •/• 256); // 乱数で 色を 変更 
myPen.CreatePen (PS. SOLID, 1, cr) ; 
pOldPen = pDC->SelectObject(&myPen) ; 

pDC->Arc(10+i, 60+i, 210-i, 260-i, 220, 160, 0, 160); // 円弧を 描画 
pDC->SelectObject (pOldPen) ; 
myPen.DeleteObjectO ; 
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ス 卜ック ベンの 利用 

Windows システムには、 利用 頻度の 高い GDI 才 ブジェク 卜が 鉍 初から いくつか 用意 さ 
れ ています。 これを ストック オブジェクトと 呼びます。 ペンに ついても、 表 1-4 に 示す 3 
神: 類の ストック 才 ブジェク 卜 （ストック ペン） が 利) 能です。 



ストック ペン 


形状 


BLACK.PEN 


黒色の 実線 （太 さ 1 : デフォルトの ペン） 


WHITE.PEN 


白色の 実線 （太 さ 1) 


NUL し _PEN 


透明 



表 1-4 ス 卜ツク ベンの 棬 M 



ストック ペンは、 いちいち 作成したり 削除す る必 •炎が なく、 たいへんで 好に 扱う ことが 
できます。 デバイス コンテキストに 初期設定 として V •えられて いる ペン も、 ストック ペン 
の 1 つの BLACK_PEN です。 

デバイス コンテキストに ストック ペンを 割り:、 丨 '丨 てるには、 CDC::SelectObject 間数では 
なく、 CDC::SelectStockObject 関 数を 使います 0 

pDC->SelectStockObject(WHITE_PEN) ; "DC に WHITE_PEN を 割り当てる 

このと き CDC::SelectStockObject WI 数は、 それまで デバイス コンテキストに 割り、 1 ' 丨 てら 
れ ていた ペンへの ポインタを 返します 。ただし、 この 関数の 返り 侦の データ 喂 は、 GDI オ 
ブジェク 卜般 を总 味す る CGdiObject クラスへの ポインタ （CGdiObject* 喂） のた め* 2 、 
CPen クラスへの ポインタに 代人す るには、 形式的に 次の ような キャストを 行う 必要が あ 
ります。 

pOldPen = (CPen*) pDC->SelectStockObject (WHITE.PEN) ; 



なお C+ + 言語では、 このように 族 底 クラス （CGdiObject クラス） への ポインタから 派 
屮 クラス （CPen クラス） への ポインタに M 変換を 行う 場合は キャストが 必要です が、 その 
逆 方 叫の 地 変換は む 動的に 行われます。 



*2 これに 対し、 CDC::SelectObjectlW 数の 場 介は、 引数の® によって 返り 侦の彻 が 與 なる c たとえば リ丨 
数の？ 0 が CPen*S なら 返り 侦の咽 も CPen * 增 に、 引数の 彻が CBrush * 嘲なら 返り 侦の彻 は CBrush * 
喂 になる 。これは CDC::SelectObject 閲 数が リ丨 数の 喂 ごとに オーバーロードされ ている ためで ある 0 
CDC :: SelectStockObjec:t 閱致 は、 int 喂の リ丨数 1 つで ストック オブジェクトを 指) U できる ので、 リ 154 
は int 甩が 1 つ だけで 丨 •分で ある 。よって、 間数の オーバーロードを する ことができない。 そのため、 
CDC::SelectStockObject 閲数は 常に CGdiObject * 喂を 返す ので ある。 
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PenTesM 関数は、 ストック ペンを 使って 線を 引く サンプルです。 ここまで 兄て きた 他の 
プログラム （ PenTestl 間数〜 PenTest 3 閲 数） と與 なり、 新しい ペンを 作らな く ともよい 
点に 注 R してく ださい （リス 卜 1-6>。 

リス 卜 1-6 ストック ベンの 利用 例： PenTest4 関数 （GIView.cpp) 

void PenTest4(CDC* pDC) // ストック ペンは 作成 および 削除の 必要がない 
{ 

CPen* pOldPen; 

pOldPen = (CPen*) pDC->SelectStockObject (BLACK.PEN) ; 
pDC->MoveTo(10, 180); 
pDC->LineTo(210, 180); 
pDC->SelectObject (pOldPen) ; 



PenTest 4 関数では、 iti •後に CDC :: SelectObject 閲 数を 実行して、 デバイス コンテ キス 
卜から BLACK _ PEN を 切り離し ています 。しかし ペンが m いままで 問 逝ない のなら、 こ 
の 作 袋は 肖 略しても よいで しょう 〇 CPenfreatePen 関数で 作成した ペンの 場合は、 W •後 

にかなら ず デバイス コンテキストから yj り 離して 削除 しないと いけませんでした か' スト ッ 
ク ペンは その 必要はありません 0 

点線の 表示 形式と 背景 描画 モード 

点線 タイプの ペン （ PS _ I ) OT 、 PS - DASH 、 1) S _ I ) ASHI )() T 、 PS - DASHDOTDOT ) を 

使う 場合は、 A 線の すきまの 兄え ノバ こも ズを 使わなくて はなり ません。 すきまの 衣 示 形式を 
ノ 1 •:イ I •する のは、 ペン 「丨 体の 設定では なく、 デバイス コンテキスト 側の 竹识 描丨由 I •モードです 。 
デバイス コンテ キス 卜の 竹说描 丨由丨 •モードには 表 1- 5 に 示す 2 神 類が あります。 



背景 描画 モード 


意味 


TRANSPARENT 


透明 モード （背景が 透けて 見える） 

■ — _ ■ . _ 


OPAQUE 


不透明 モード （CDC::SetBkColor 関数で 指定した 背景 色が 
表示され る） 



表 1-5 «最 描画 モード 



PenTest 5 間数は、 背景 描 i 由 j モードの 違いで 点線の 表示が どのように 変わる かを 見る サ 
ン プルです （リス 卜 1-7)。 
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リスト 1-7 背景 酬 モードが 点線の 表示に 与える 影響： p en Test 5 関数 （ GIView . cpp ) 



void PenTest5(CDC* pDC) // 点線 タイプの ペンと 背景 描画 モードの 閗係 

{ 

CPen myPen(FS_DOT, 1, RGB(255, 0, 0)); 

CPen* pOldPen; 

pOldPen = pDC->SelectObject (&mvPen) ; 

pDC->SetBkMode (TRANSPARENT) ; // 透明 モード 

pDC->MoveTo(10, 200); 
pDC->LineTo(210, 200); 

pDC->SetBkMode (OPAQUE) ; // 不透明 モード 

pDC->SetBkColor(RGB(0, 0 ， 255)); // 背景 色を 指定す る 

pDC->MoveTo(10, 210); 
pDC->LineTo(210, 210); 

pDC->SelectObject (pOldPen) ; 



PenTest 5 間数は、 丨"1 じ ペンを 使って、 PS — DOT スタイルの 亦い 点線を 2 本 衣ボ する も 
のです が、 W : 初は 次のように デバイス コンテキストを TRANSPARENT (透明） モードに 
•没 记 しています 〇 TRANSPARENT モードでは 办線 のす きまに 何も 衣 示されず 、竹は が 透 
けて 见 えます。 

pDC->SetBkMode (TRANSPARENT) ; // 背景 描画 モードを TRANSPARENT に拉定 

そして 2 本 II の 敗 線を 引く 前に、 デバイス コンテキストを OPAQUE (小 透明） モードに 

設定し、 さらに 背议 色を 青と しています。 背说 色の 設定には CDC :: SetBkColor 関数を 使用 
します。 



pDC->SetBkMode (OPAQUE) ; // 背景 描画 モードを OPAQUE に K 定 

pDC->SetBkColor(RGB(0, 0, 255)); // 背* 色を 青に 拉定 

OPAQUE モードでは、 CDC コ SetBkColor 問 数で 指定した 色で 竹议 が 飨られ ます。 結果 
として、 この場合は ペン 自体の 赤色と 背 设の许 色が 交 瓦に 並んだ 点線が 表示され ます。 敁 
後に PenTest 5 の 実行 結果を 示して おきます （図 1 -6 ) 。 






1.2 GDI 才 ブジェク 卜 一 ペンと ブラシと ビットマップ 




図 1-6 PenTest 5 閩 致の 実行 結果 



•ブラシの 利用 法 —— 図形の 塗りつぶし スタイルを 指定す る 

ブラシは CDC::Rectangle 関数 や CDC::Ellipsel»J 数で 矩形 や 格 円を 描く ときに、 その内 
部を 飧 りつぶ すのに 利 州され る GDI 才 ブジェク 卜です。 Windows では さまざまな ブラシ 
が 利 川で きます が、 ここでは ザ. 色の ソリッド ブラシと、- 中 •純な 線 パターン からなる ハッチ 
ブラシの 使い方を 説明し ます 0 



G2 フロ ジエク 卜の 投計 

それでは、 ペンの GDI オブジェクトの 实 際を 兑 ていく 前に、 テスト ブロ グラムを 記述す 
るた めの プロジェクトを 作成して おき ましょう。 以下は AppWizard と、 その オプション 
で 定める アブリ ケー シ ョンの 拃糾 みです。 

♦プロジェクト 名： G2 
春 アブリ ケー シ ヨンの タイプ： SDI 
籲 データベースの サポート： しない 
•複合 ドキュメントの サポート： しない 
•ツール バー/ " ステータス バー： なし 
春 印刷と 印刷 プレビュー： なし 
春 そのほか： デフ オルトの まま 

上の 方針に 従って、 AppWizard で プロジェクトを 新規に 開始して ください 。そして ス 
ケルトンが 完成したら、 G1 プロジェクトの ときと 问 様に、 G2View.cpp の OnDraw 関数 
の 辺りを リスト 1-8 のように 修丨丨 •: してく ださい 〇 BrushTestl 〜 BrushTest3 の 3 つの 閲数 
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は、 それぞれ OnDraw 間数から 呼び出されて、 ブラシを 使った 簡単な テストを 行う もので 
すが \ こ こでは とりあえず 問 数の 人 门 だけ) 丨 丨盘 して おきます。 



リスト 1-8 ブラシ テス 卜の 前 準備 （ G 2 View . cpp ) 

1111111111111111111111111111111111111111 
// CG2View クラスの 描画 
void BrushTestl(CDC* pDC) 



void BrushTest2(CDC* pDC) 



void BrushTest3(CDC* pDC) 



void CG2View: :OnDraw(CDC* pDC) 

{ 

pDC->Text0ut(16, 20, "TEST 1") ; BrushTestl(pDC) 

pDC->Text0ut(16, 180, "TEST 2 M ); BrushTest2(pDC) 
pDC->Text0ut(216, 100, "TEST3"); BrushTest3(pDC) 



ブラシの 作成 

ブラシの GDI 才 ブジェク 卜は CBrush クラスで 竹 邢 します。 ブラシを 利⑴ する には、 ま 
ず W 初に CBrush クラスの オブジェクトを 定義し ます。 

CBrush myBrush; 

そして GDI 才 ブジェク 卜の ブラシを 作成し、 この オブジェクトと 結び付けます。 ブラシ 
を 作成す る 問 数は、 ペンの 坳 介と 與 なり、 ブラシの 神: 類 ごとに ⑴总 されて います。 

ソリッド ブラシは CBrush::CreateSo 丨 idBrush 問 数を 使って 作成し ます。 この 閲 数は 引 
数で ブラシの 論 押 •カラーを 指) ii します。 たとえば 次の例ではみ い 中. 色の ブラシが 作成され 
ます。 

myBrush.CreateSoliciBrush(RGB(255, 0, 0)); // ソリッド ブラシ 

なお ソリッド ブラシの 炎 尔の際 には、 論现 カラーに 対して ディ ザ リングが 行われる ので、 
256 色し か 衣/ できない ハードゥェア でも 擬似 的に 1670 万 色が 表現で きます。 



1.2 GDI オブジェクト 一 ペンと ブラシと ビットマップ 



ハツ チ ブラシの 作成には CBrus ヒ CreateHatchBrush 間数を 使 州し ます。 この 閲 数は 第 1 
リ丨 数で ハッチ パターンを 指记 し、 第 2 リ丨 数で 論 坪 カラーを 指记 します。 次の 例は HS 胃 CROSS 
形式 （縦横の 格户投 様 〗 の丨 1 i •い ハッチ ブラシを 作る ものです， 

myBrush.CreateHatchBrush(HS-CROSS, RGB(0, 0, 255)); // ハッチ ブラシ 
ハッチ パターンは、 表 1-6 に 示す 6 種類が あります 0 



ハッチ バター ン 


形状 


HS.HORIZONTAL 


横線 


HS.VERTICAL 


縱線 


HS.BDIAGONAL 


右上が りの 斜め 線 


HS.FDIAGONAL 


左上が りの 斜め 線 


HS-CROSS 


縦横の 格子 


HS.DIAGCROSS 


斜めの 格子 



表 1-6 八 ツチ パターンの 稽類 



ハッ チ ブラシを 作成す る 場 作は、 リ丨 数に 指定した 論理 カラーが 純 色 化されて 衣 示され ま 
す。 つまり 災 際の ハッチ ブラシの 色は、 ハードウェアの 衣 示 能力に 制限され ると いう こと 
です。 

さて、 作成した ブラシは、 ペンと M 様に CDC :. Se 丨 ectObjectlW 数を％ 行し、 デバイス コ 
ン テキス 卜に 削り、 丨 1 てます が、 このと き SdectObject 間数は、 デバイス コンテキスト がそ 
れ まで 使 川して いた ブラシへの ポインタを 返します。 

CBrush* pOldBrush; 

pOldBrush = pDC->SelectObject (&myBrush) ; 

li " ri では、 ペンの 選択 剛こ CDC :: Se 丨 ectObject 関 数が CPen * 咽の)/:: り侦を 返す ことを 説 
明し ました 。しかし ブラシを 選択す る埸 •介は、 CDC :: Se 丨 ectObjectlW 数の W り倘は CBrush * 

彻 になる のです。 これ も C + + •〖•沿の 閲 数の オーバーロードを 利 川した ものです 

デバイス コンテキストに ブラシを 剖り、 レ 丨 てると、 以後は その ブラシに よって 丨ズ丨 形の 内邰 
が 喰り つぶされる ようになります こうして 描 丨| 丨丨丨 •を 終えて 川 済みに なった ブラシは、 ペン 
と M 様に、 システム メモリから 削除して ください。 



pDC->Select0bject(p01dBrush) ; //myBrush を 切り離す 

myBrush . Delet eOb j ect ( ) ; " ブラシの GD 丨オ ブジェク 卜を 削除す る 



リス 卜 1-9 は 実際に ブラシを 利用した ブロ グラム 例です。 BrushTestl 関数は、 赤いソ 
リッ ド ブラシで 喰られ た 丨リ と、 吖の ハッチ ブラシで 飨られ た 丨リ を 衣 示します （問 卜？ レ 
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リス 卜 1-9 ブラシの 作成と 利用： BrushTestl M 数 （ G2View. 卬 p) 

void BrushTestKCDC* pDC) // ブラシの 作成と 削除 

CBrush myBrush ; 

CBrush* pOldBrush; 



myBrush. CreateSolidBrush (RGB (255, 0, 0)); 
pOldBrush = pDC->SelectObject (ftmyBrush) ; 
pDC->Ellipse(60, 10, 160 ， 110); 
pDC->SelectObject (pOldBrush) ; 
myBrush. DeleteObjectO ; 



"ソリッド ブラシの 作成 
// myBrush を iM 択 

"もとに 戻す 
"ブラシを 削除 




myBrush .Cr eat eHatchBrush(HS-CROSS, RGB (0, 0, 255)); //z \ ッチ ブラシの 作成 
pOldBrush = pDC->SelectObject (femyBrush) ; // myBrush を iM 択 

pDC->Ellipse(110 f 10, 210, 110); 

pDC->SelectObject (pOldBrush) ; // もとに 戻す 

myBrush. DeleteObjectO ; // ブラシを 削除 




塗りつぶし 

TEST 2 



BrushTestl 関数の 実行 Bffi 



1.2 GDI 才 ブジェク! ペンと ブラシと ビットマップ 



引数を 持つ コンストラクタ 

CBrush クラスでは、 コンストラクタに 兮 える 引数に よって、 與 なる M 類の ブラシを 作 
る ことができます 。ソリッド ブラシを 作成す るには、 次のように 論理 カラーを 唯一の 引数 
として オブジェクトを 定義し ます。 

CBrush myBrush(RGB(255, 255, 0)); // ソリッド ブラシ 

ハッチ ブラシを 作成す るには、 次のように 第 1 リ丨 数に ハッチ パターン、 第 2 リ丨 数に 論理 
カラーを 指定して 変数を 定義し ます。 

CBrush myBrush(HS_DIAGCROSS, RGB (0， 255, 0)); // ハッチ ブラシ 

ス 卜ック ブラシの 利用 

ストック 才 ブジェク 卜と して Windows システム 内に あらかじめ) 丨 されて いる ブラシ 
のこと を ストック ブラシと 呼びます 。ストック ブラシには 表 1-7 に 示す ものが あります 0 



ストック ブラシ 


形状 


論理 カラー 


BLACK_BRUSH 


黒色の ソリッド ブラシ 


RGB(0, 0.0) 


DKGRAY.BRUSH 


暗い 灰色の ソリッド ブラシ 


RGB( 64, 64.64) 


GRAY_BRUSH 1 


灰色の ソリッド ブラシ 


RGB(128, 128, 128) 


し TGRAY-BRUSH 


明るい 灰色の ソリッド ブラシ 


RGB(192, 192, 192) 


WHITE-BRUSH 




RGB(255, 255, 255) 


NU しし _BRUSH 






HO し LOW_BRUSH 







表 1-7 ストック ブラシの 稽類 



デフ オルトの 状態では、 デバイス コンテキストには WHITE_BRUSH が 与 •えられて いま 
す。 ストック ブラシを デバイス コンテキストに 割り当て るには、 次のように CDC::SelectStoc 
kObjectliy 数を 使って ください。 

pOldBrush = (CBrush*) pDC->SelectStockObject (NULL.BRUSH) ; 

ストック ブラシの 屮 でも iE 要な ものが、 NULL_BRUSH (または HOLLOW_BRUSH) で 
表される ヌル ブラシです。 ヌル ブラシは 透明 色 ブラシ、 つまり 丨由 j 而に 何も 飨ら ない ブラシ 
です。 间 形の 枠 だけを 描く 場合には ヌル ブラシを 使います。 

リス 卜 1-10 に ヌル ブラシを 使う サン ブルを 示します 。この BrushTest2 関数を 実行す 
ると 丨リ の拃 だけが 描かれる ことを 確認して ください （図 1-8)。 
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リス 卜 1-10 ヌル ブラシを 使う： BrushTest 2 関数 （ G 2 View . cpp ) 



void BrushTest2(CDC* pDC) // ヌル ブラシは 塗らない 

{ 

CBrush* pOldBrush; 

pOldBrush = (CBrush*) pDC->SelectStockObject (NULL.BRUSH) ; 
pDC->Ellipse(60, 170, 160, 270); 
pDC->Ellipse(110, 170, 210, 270 )； 
pDC->SelectObject (pOldBrush) ; 




図 1-8 BrushTest 2 閩 数の 実行 結 栗 



八 ツチ ブラシと 背景 描画 モード 

ハツ チ ブラシの パターンの すきまは、 点線の すきまの 場合と M 様に、 デバイス コン テキ 
ストの 背拔 •描 丨_ •モードに よって 衣 示 様式が 変わります 0 
デバイス コンテキストを OPAQUE モードに 設定す ると、 ハッチ ブラシの すきまは 行识 
色で 飨り つぶされます 0 ただし このと き ff 说 色は 純 色 化されます 3 •方、 デバイス コンテ 

キ ストを TRANSPARENT モードに すると、 ハッチ ブラシの 線 パターン のみが 表, J ;- さ 
れ 、パターンの すきまは 透明になります。 

リス 卜 1-11 は、 行;;!: 描 丨由丨 •モードの 設记が ハッチ ブラシに びえ る釤释 を兑る サンプルです: 
TRANSPARENT モードでは ドの 絵が 透けて 兑 える ところに 注 |1 してく ださい （図 1_ 9) 。 




.2 GDI オブジェクト 一 ベンと ブラシと ビットマップ 



リス 卜 1-11 背 S 描画 モードが ハッチ ブラシに 与える 影 *: BrushTest3 関数 （ G2Viewxpp) 



void BrushTest3(CDC* pDC) // ハッチ ブラシと 背景 描画 モードの 関係 

{ 

CBrush myBrushKHS.FDI AGONAL, RGB(0, 0, 0)); 

CBrush myBrush2(HS.BDI AGONAL, RGB(0, 0, 0)); 

CBrush* pOldBrush; 



pDC->SetBkMode (OPAQUE) ; // OPAQUE モ- 卜では 

pDC->SetBkColor(RGB(0, 255, 255)); // 線の 間が 背景 色で 塗られる 

pOldBrush = pDC->SelectObject (&myBrushl) ; 
pDC->Ellipse(260, 100, 360, 180); 



pDC->SetBkMode (TRANSPARENT) ; 
pDC->Select0bject(&myBrush2) ; 
pDC->Ellipse(310, 100, 410, 180); 



"TRANSPARENT モードは 
// 線の 間が 透けて 見える 







•ビッ 卜 マップの 利用 法 —— 任意 図形の 表示 

ビットマップの 場 介は、 ペン や ブラシよりも 利用 手順が 少 々複雑です 。まず ビット マッ 
ブの 図形 データを 用意し なければ なりません。 また ビットマップを 闸而に 表示す るた めに 
は、 メモリ デバイス コンテキストの 利 Jlj 方法 や、 ビット ブリット ビット ブロック 
転送 命令） の 使い 力 •も觉 える 必要が あります。 

G 3 プロジェクトの 設計と リソースの 準備 

G3 プロジェクトでは ビットマップ 丨ズ丨 形を クライアント 領域に 衣氺 する プログラムを 作成 
します。 プログラム の# 作は、 0nl) raw 関数を 利〗 |j して、 あらかじめ 川 尨した ビット マッ 
ブ は I 形を クライアント 領域 一杯に •放き 詰めて 衣, ji する だけの 簡 中. な ものです。 

まず AppWizard を 起# して、 以 ドの オプション 設 走で スケルトン ブロ グラムを 作成し 
てくだ さい。 

春 プロジェクト 名： G3 
參 アブリ ケー シ ヨンの タイプ： SDI 
鲁 データベースの サポート： しない 
♦极介 ドキュメントの サポート： しない 
•ツール バー/ステ 一夕 スバ 一： なし 
♦印刷と 印刷 プレビュー： なし 
春 そのほか： デフ オルトの まま 

ビット マッ ブ図 形の デ-夕を 用总 する 方法は いくつかあります が、 その 中で 一 挢簡丨 取な の 
は、 ビット マッ ブ リソースを 利用す る 方法です 〇 Developer Studio 内に 含まれて いるグ ラ 
フィ ックェ デ ィタを 使えば; p •作 袋で ビットマップ リソースを 作成す る こと もで 冬ます が、 こ 
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インボー 卜したい ものを iM 択 して 
[インボー 卜】 を クリック 



図 1-10 [リソースの 挿入] ダイアログ ボックス 



こでは 付诚 CD - ROM の G 3 プロジェクト 内に ある、 vc 60. bmp を 利 JII しました。 ’ 奥 際に、 
本 プログラムを 作成す る 場合には、 この ビットマップを 流) li する か、 あるいは 適当な もの 
を 使用す るよう にして ください。 

メニューから [挿入] 一 [リソース] を 選択す ると、 [リソースの 揷 人] ダイアログ ボック 
スが 表示され るので、 く インポート > ボタンを クリックして ください。 次に [リソースの 
インポート] ダイアログ ボックスで 、[ファイルの 神: 類] に [すべての ファイル （*•*)] を 指 
定 して、 望みの ファイル （ここでは vc 60. bmp ) を 選択し、 < インポート〉 ボタンを ク リツ 
ク すれば、 ビットマップ ファイルを インポート する ことができます （図 1-1〇) 〇 

く イン ボート〉 ボタンを クリック すると、 丨由 ilf 丨丨 •には グラフ イツ クェ デイ 夕が 現れ、 そこ 
に 指 沿した ファイルから データが 説み 込まれ、 ビットマップが 表示され ます （図 1 - 1 1 ) 〇 




グラフィック エディタの 丨由 丨丨如 •（ただし 衣/ されて いる ビットマップ 丨ズ丨 形の 外側） を ダブル 
クリック すると、 図 1-12 のよう な プロ パ テイ ボックスが 開きます 0 




図 1-12 ブロ パティ ボックス 



ブロ パティ ボックスには、 ビットマップの ID や サイズが 表示され ています。 ここでは 
[ID] ボックスに 表示され た ビットマップの リソース ID を 「 IDB _ SAMPLEBMP 」 に 変更 
してく ださい 。以上で ビットマップ リソースの 嘈備は 完了です 0 
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ビッ卜 マップの 表示 

ビット マッ プリ ソースから、 CBitmap クラスの オブジェクトを 作成す るには、 CBitmap 土 
oadBitmap 関数を 利〗 丨 j します。 この 閲 数は 引数に 指定され た ビットマップ リソース id (リ 

ソー スエ デ ィタで 指 走した もの） から ビットマップを 作成す る ものです： 

CBitmap Bitmap; 

Bitmap . LoadBitmap ( IDB.SAMPLEBMP) ; 

ビットマップを 画面に 表示す る 方法は、 他の GDI オブジェクトを 画面に 表示す る 方法と 
は少 々與 なります 。衣, ji したい デバイス コンテキスト に砍接 その ビットマップを 剂り 内て 
るので はなく （SelectObject 丨汨 数を 灾 むする のでは なく）、 メモリ デバイス コンテ キス 卜と 
いう 特殊な デバイス コンテキストを データ 耘送の サポート 役と して 利 川し、 まずは この サ 
ポー 卜 役に ビットマップを 割り当てる のです。 

メモリ デバイス コンテ キス 卜とは、 メモリ 内部に •没 けられた 擬似 的な 丨由丨 •血の デバイス コ 
ン テキストの ことです。 ここでは 丨由丨 •丨 〖丨丨 •バッファの 役 剖を 米た す存作 だと m って もらえれば 
IHJ 迫い ないで しよう 。メモリ デバイス コンテキストを 利) |j する には、 まず CDC クラスの 
オブジェクトを 1 つ J|j 总 します。 

CDC MemDC; 

そして この MemDC に 対し、 CDC::CreateCompatib 丨 eDCIW 数を拟 f します。 この 閲数 

は デバイス コンテキストへの ポインタを 引数と し、 リ丨 数に 指定した デバイス コンテ キス 卜 
と M じ 炎 小 能ノ J ( k に 発色 能力） を 備えた メモリ デバイス コンテキストを 作成し ます， 

MemDC.CreateCompatibleDC(pDC) ; 

ここまでの 段附 では、 メモリ デバイス コンテキストは 丨由丨 •血に 相 出す る データ バッファを 
持っ ていません 。そこで さきほど ビットマップ リソースを 説み 込んで 作った ビットマップ 
才 ブジェク 卜を、 CDC::SelectObject 1541 数を 使って この メモリ デバイス コンテキストに 削 
り、 1 i てます 。すると、 この ビットマップが、 メモリ デバイス コンテキストの _ |f 丨丨 になる わ 
けです。 

pOldBitmap = MemDC.SelectObject C&Bitmap) ; 

一う して％ 成した メモリ デバイス コンテキストは、 ディスプレイ _• 丨( 丨丨 •の デバイス コンテ 
キ ストを 扱 うかのよ うに、 データを 出力す る こと もで きれば、 データを 読み取る こと もで 
きます。 ただし その 結 米 •は 当然ながら メモリ 中の データと して 記録され る だけで、 丨 丨に以 
える 変化は 何も 生じません。 



卜 一 ペンと ブラシと ビッ 



そこで、 CDQBitBh 丨幻 数と いう 問 数が 登坳 します。 この 間数は、 図 1-13 に 示す ように、 
送无の デバイス コンテキスト 丨 •.の fT :,& の 妬 形 データを fe 送 光の デバイス コンテキストの 
任 立の 位 阶に虹 送す る ものです， 

pDC->BitBlt (dx , dy, dw, dh, pSrcDC, sx, sy, rop) ; 

転送先の デバイス コン 転送 元の デバイス コン 

テキス 卜 テキス 卜 

(〇. 〇) (〇. 〇) 




( dx . dy ) : デバイス コンテ キス 卜の どこに 転送す るかを 指定 
dh : 転送す る ビッ卜 マップの 高さ 
dw : 転送す る ビッ卜 マップの 輻 
( sx . sy ) : デバイス コンテ キス 卜の どこから 転送す るかを 指定 

0 1-13 ビッ卜 ブリッ 卜の K 送 元と 転送先の 座標 指定 

CDC::BitBlt 閲 数の 第 8 リ I 数は、 転送 无の データと 紅 •送 先の デ一夕の 間で 行われる ラス 
タ才 ペレ ーシ ヨン （ビットごとの 論邢演 灯） の MS 丨を记 めます。 指记 できる ラスタ オペ レー 
シ ョンの 中で 代 衣 的な ものを 表 1-8 に， ji します， また、 ラス 夕 オペレーションを 行う とど 
んな 結果になる かを 図 1-14 に/〗 とします。 

CI)C::BitBlt 間数を 利 川して、 メモリ デバイス コンテキストから デ ィス ブレイ 丨丨 丨丨 j 丨(丨丨 •の デバ 
イス コンテ キス 卜に グラフィック データを 虹 送す る ことで、 ようやく 丨丨 的の ビットマップ 
が デ イス プレイに 衣/ ji されます。 

また、 アブリ ケー シ ヨンの クライアント 領域の サイズを 得る には c W 丨 id::GetClientRect 



ラスタ オペレーション 


論理演算 


意味 


SRCCOPY 


dst = src 


転送 元の パターンを 上* き 


NOTSRCCOPY 


dst = • src 


紜 送 元の パターンを 反転して 上 害き 


SRCPAINT 


dst = dst 1 src 


転送 元と 転送先の パターンの 〇 R を 取る 


SRCAND 


dst = dst & src 

^ 


転送 元と 転送先の パターンの AND を 取る 


SRCINVERT 


dst = dst ^ src 


転送 元と 転送先の パターンの X 〇 R を 取る 


SRCERASE 


dst = _ dst & src 


転送 元の パターンを 転送先の パターンから 消去 



ft 表 的な ラス タオべ レー 
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転送 元の パターン 

(SRC) 




転送先の バター ン 
(DST) 



ラスタ 才 ベレー シ ヨンに よる DST の 変 < 匕 



SRCCOPY 



SRCAND 



NOTSRCCOPY 




SRCINVEFTT 



図 1-14 ラスタ 才 ベレー シ ヨン 



SRCPAIIMT 



SRCERASE 







間数を 使います 。この 問 数は ゥィンドゥの クライアント 領域の 座標を 引数に 指定した CRect 
クラス （または RECT 構造体） の オブジェクトに セットし ます。 CRect クラス/ ^RECT 構 
造 体は 共に ある 2 点で 決定す る 矩形 領域の 位 沢と その サイズを 扱う のに 利 爪され ます。 

ここで 説明した ことを 組み 介 わせる と、 ビットマップを 衣 示す る OnDrawWI 数は リスト 
1-12 のよう な ブロ グラムに なります。 

リスト 1-12 ビットマップを 転送す る テスト （ G 3 View . cpp ) 

void CG3View: :OnDraw(CDC* pDC) 

{ 

CBitmap Bitmap, *p01dBitmap; 

CDC MemDC; // メモリ デバイス コンテキストの 用意 
int x, y; 

CRect rect; 

Bitmap . LoadBi tmap ( IDB.SAMPLEBMP) ; 

// リソース エディタで 作成した ビットマップから CBitmap オブジェクトを 作成 

MemDC.CreateCompatibleDC(pDC) ; 

pOldBitmap = MemDC.SelectObject(&Bitmap); // ビットマップを 割り当てる 

GetClientRect(&rect) ; / ノウ ィン ドウの サイズを rect に 記憶す る 

for vy = 0; y < rect.bottom; y += 85) ■( // ビットマップの* さは 85 ドット 

for (x = 0; x < rect. right; x += 340) {// ビットマップの 幅は 340 ドット 
pDC->BitBlt(x, y, 340, 85, &MemDC, 0, 0, SRCCOPY); // ビットマップの 転送 

> 

} 

MemDC. Select 0b ject(pOldBitmap) ; 










1.2 GDI 才 ブジェク! ベンと ブラシと ビットマップ 



リスト 1-12 に尔 すよう に （) 丨 il)ra\v 閲 数を •丨ト き 換えて、 プロジェクトを コンパイル/実 
行す ると 図 1-15 のように ビットマップが ウインドウ 令 体に 衣 示されます。 
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図 1-15 実行 画面 





2 メニューを 使って みよう 



GDI は 丨丨丨 liifn'm 力に 閲 する 統 •インターフェイスを 火现 する もので したが、 Windows は 
ユーザーが アプリケーションを 操作す るた めの 統 •的な ユーザー インターフェイス も 備え 
ています」 その 丨 丨 1 核と なる ものが メニューと ダイアログ ボックスです そこで、 このく マ: と 
次の C では メニュー や ダイアログ ボックスの 使い" を •说 明 します 

AppWizard が 作成す る スケルトンには、 •般 的な メニューが あらかじめ 川 •なされて いま 
す。 プログラマは、 この スケルトン メニューを もとに、 丨 ，丨 分の 丨 I 的に 介った 惝 成の メニュー 
を 作る ことになります 3 從 束の Windows プログラミング における メニュー まわりの ブロ 
グ ラミングと 比べ 、 Visual C + + での メニューの 扱いは 非常に 簡丨 p •です: 

メニュー 処 押 •の プログラミング r : n(i は、 プログラムが \ ii)i でも si)i でも 人; s ありませ 
ん 。ここでは si ) i 形式の プログラムを 使って 说 明を します 



2.1 スケルトンの 作成 

まず AppWizard を 起動して、 丨 ••台と なる スケルトンを 作成し ましょう。 これから 作成 
する プロジェクトは、 以 ドの ような ものです， 

•プロジェクト 名： Meni 丨 Test 
參 アプリケーション タイプ ： SDI 
•データベースの サボー 卜： しない 
參梭合 ドキュメントの サボー 卜： しない 
•ツール バー ステータス バー： なし 
♦印刷と 印刷 プレビュー： なし 
♦そのほか： デフ オルトの まま 

以 I ••のよう な灸 fl ••に 從 つて、 AppWizard で オプションを, &定 してく ださい。 設定が 済 



2 メニューを 使って みよう 
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図 2-1 デフ オル 卜の メニュー 

ん だら、 例によってく 終 r>、 < ok > の 恥に ボタンを クリックして スケルトンを 作成して 
ください 。スケルトンを コンパイル 火む すると、 図 2-1 のよう な丨由 j ぱ丨丨 •が 衣ボ されます 0 

図 2-1 を U れば わかる ように、 スケルトンには デフ オルトの メニューが 'えられて いま 
す。 メニュー バーに 衣 氺 される トップ メニューには [ファイル] 、[編 災] 、[ヘルプ] の 3 
つが あり、 これらの トップ メニューを クリック すれば、 それぞれ プルダウン メニューが 衣 
尔 されます 。ただし、 これらの メニューは そのままでは ちゃんと# 作し ません 0 というの 
は、 これらの メニュー 识丨丨 には まだ 対応す る コード （その メニュー 項丨| が 選択され ると 災 
行され る コード） が •別り、 1 〗 てられて いないから です。 また、 これから 作成す る ブロ グラム 
には 必贤 がない ので 削除す る 項丨丨 や、 逆に) £1 加し なければ いけない 項 丨丨 も あり、 この 構成 
のままでは 使えません。 

そこで、 リソース エディタと ClassWizard を 使 川す る ことになります 。リソース エディ 
夕は メニューを 褊染 （メニュー jf (丨丨 の幣押 •や 沿 加） する のに 使い、 Ci assW i zar d は リソース 
エデ ィタで 作成した メニューに プログラム コードを 割 丨） 、 丨 '丨 てるのに 使います。 それでは、 
これから _ ッールの 使い方を 詳しく 説明して いきましょう。 

2.2 メニュー 項目の 削除 

メニューは Windows の リソースの 1 つで、 リソース エディタで その内 料を チェックした 
り、 修丨丨 •: をしたり する ことができます。 

メニューを 編集す るには、 Developer Studio の ワーク スペース ウィンドウで [Resource 



2.2 メニュー 項目の 削除 



View ] タブを クリックし、 [ …… リソース] という フォルダ （ここでは [ MenuTest リ ソー 
ス]) を ダブル クリック します。 すると、 ブロ グラムの リソース スクリプト （ここでは 
MenuTest . rc ) の 読み込みが 始まります。 リソース スクリプトは、 プロジェクトの リ ソー 
スの 設定を 記述した テキストファイルで、 「. re 」 という 拡张 ，•を 持って います 0 

リソース スクリプトの ■み 込みが 終わる と、 プロジェクト ワーク スペース ウインドウに 
は、 その プロジェクトで 使用され ている リソースの 神: 類が ー览衣 > ji されます （図 2-2) 0 
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図 2-2 リソースの 種類を 一 M 表示した ところ 

现 在の 丨丨 的は メニューの 褊災 なので、 [ MenuTest リソース] の ドに ある [ Menu ] を ダ 
ブルク リック、 あるいは その Ai 側に ある + 記け を クリック します。 すると その ドに、 プロ 
ジェク 卜に 含まれる すべての メニューの リソース II ) が 衣/ ji されます （ MenuTest ブ ロジェ 
クトは メニューを 1 つし か 持って いないので、 「 IDR - MAINFRAME 」 という リソース ID 
が 1 個 表示され る だけで ある） 。第 1 部で も 触れました が、 リソース ID とは プロジェクト 
の 随所で リソース 指定の ために 使われる 整数 侦 で、 Resource . h などの インクルード フ アイ 
ルで 名前が 付けられ ています 0 
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図 2-3 riDR . MAINFRAMEJ とし、 う リソース ID が 表示され た 

編集したい メニューの リソース ID (ここでは idr _ mainfrAme ) を ダブル クリックす 
ると、 メニュー エディ 夕の ウィンドウが 開きます （図 2-4)0 





0 2-4 メニュー エディタが 開いた ところ 



ウインドウの 丨 ••部には 選択した メニューが ブロ グラムの 欠 行” と ほとんど M じ 形で 衣尔 
されます。 トップ メニューを クリック すれば、 その 下の ブルダ ウン メニュー も 姿を 见 せま 
す 〇 ' 火 際の メニューと 迫う のは、 トップ メニューの イ丨 •端 や プルダウン メニューの ili •ド 行に 
乍 丨'丨 の 叫/ 〇 形 （ニュー アイテム ボックス） が 押 かれて いる ことです が、 これは 後述す るよう 
に、 メニュー 埙 目を 追加す る 位 is を 示します 0 

また 人 枠の 叫 灼 形は、 现 丫丨 している メニュー 项丨丨 を/ す カーソルです。 別の メニュー 
项丨1 を マウスで クリック すると、 カーソルは その 位 阶 に移勋 します。 [iTab] や 矢印 キーを 
押して、 拟 |丨 ごとに カーソルを 船 次 移動す る こと もで きます。 




図 2-5 [ファイル] の プルダウン メニューを 表示した ところ 



ところで、 この 草で 作成す る プログラムは、 ファイルの 説み # きは いっさいし ません。 
よって、 ファイル アクセスに 閲 する メニュー 項丨丨 は 必要ありません 。これらは 邪 | 級な だけ 
なので、 削除して しまいましょう。 

まず [ファイル] メニューの [新規 作成] に カーソルを 合わせ、；^ ei^ を 押します。 これ 
で [新規 作成] の メニュー 埙丨1 が 削除され るは ずです （図 2-6) 0 以ド 同様に、 [開く]、 [上 
書き 保存] …… と 削除して いきます。 項目を 区切る セ パレ一夕 （横線） も、 やはり その上に 
カーソルを 介 わせて [Delei^ を 押せば 削除で きます。 図 2-6 に 示す ようにして、 [アプリ ケー 
シ ヨンの 終了] だけ 残し、 あとは すべて 削除して ください。 




一項 目の 削除 
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図 2-6 フ アイ ル 操作 用の いくつかの メニュー 項目を 削除した ところ 

お 隣の [編 災] メニューの 中には、 今 N 必要と する 项丨丨 は 1 つもありません。 よ， 

ちらは 根 こそぎ 削除して しまいます。 卜ッブ メニューの [編 f 太;] に カーソルを 介 わせ- 
を 押す と、 図 2-7 のよう な ダイアログ ボックスが 衣, /く される ので、 <0K> ボタンを クリッ 

ク してく たさい。 これで. 編 叱： メニューは その ドの ブルダ ウン メニューを 穴め完 令に 削除 
されます） 






!• 7 イテ 含まれ 2>す/^<〇 メこ r •アイテム す • 



tpr ::」 キ， >〇レ 



図 2-7 卜ップ メニュー 削除の 確 K ダイアログ ボックス 

以丨 ••で イく盟 な メニュー 拟丨 丨 はすべ て 取り除かれ ました。 ブロ グラムを 外 コンパイルして 

ニ ューは 図 2-8 のように 変 史 されて いるは ずです。 



MenuTest 




図 2-8 . 



変更 後の プログラムの 実行 画面 




2 メニューを 使って みよう 



2.3 メニュー 項目の 追加 

不要な 坝 丨丨 が 幣理 され、 すっきりした ところで、 今度は メニューに 新しい 項目を 追加し 
てみ ましょう。 

メニューを 使った 操作の 対象と して、 リスト 2-2 のよう な 図形 表示 ブロ グラムを 用意し 
ました 〇 CMenuTestView :: OnDraw 間数は、 myCircle 閲 数と myLine 間数を 呼び出して 
顔を 描きます 。そこでまず、 MenuTestView.cpp の リス 卜 2-1 に 示す 部分を リス 卜 2-2 の 
ように 修正して ください。 

これらの 閲 数は、 I リと丨 f (線を 糾み 合わせて 顔を 描く だけの ものです が、 ロの 形、 右 HO 
向き、 左 F1 の 向き、 の 上下、 VI の 太 さとい う 5 つの パラメ 一夕を 持ち、 それらを 個別に 
変 史 する ことができます。 各 パラメータは リス 卜 2-2 の 先頭に 示す グローバル 変数で 筲理 
しています 。本来 これらの データは ドキュメント クラスを 利 州して 荇理 をす るべき もので 
すが、 ここでは 話を 簡 中. に する ために グローバル 変数と して 竹 する ことにしました。 

そこで、 メニューを 利用して これらの 変数の 侦を埘 減 させ、 いろいろな 表情を 作って み 
ようとい うわけ です。 いっぺんに 完成 させようと 思う とたい へんです から、 簡中 •なと ころ 
から 順々 に 仕 •上げて いくこと にしましょう 0 

リスト 2- 1 脩 正 前の リス 卜 （ MenuTestView.cpp) 

111111111111111111111111111111111111111 
// CMenuTestView クラスの 描画 

void CMenuTestView: :OnDraw(CDC* pDC) 

{ 

CMenuTestDoc* pDoc = GetDocument () ; 

ASSERT_VALID(pDoc) ; 

// TODO: この 塌 所に ネイティブ データ 用の 描画 コードを 追加し ます。 



リス 卜 2-2 顔を 描く 関数 群 （ MenuTestViewxpp) 



111111 111111111111111111111111111111111 
// CMenuTestView クラスの 描画 



int MouthPos = -10 
int RtEyePos = 10; 
int LtEyePos = -10 
int BrowPos =0; 
int BrowWidth = 3 



// ロの 上げ下げ 
// 右目の 左右の 位 » 
// 左目の 左右の 位置 
// 眉の 上げ下げ 
// 眉の 太 さ 



2.3 メニュー 項目の 追加 



void myCircle(CDC* pDC, int x, int y, int r, int brush) 

{ 

pDC->SelectStockObject (brush) ; 

pDC->Ellipse(x - r, y - r, x + r, v + r); "(x,y> を 中心に 半径 r の 円を 描く 



void rayLine(CDC* pDC, int x, int y, int dx, int dy, int width) 

{ 

CPen Pen(PS_SOLID, width, RGB(0,0,0)); // 指定した 太 さ （width) の 

CPen* pOldPen = pDC->SelectObject(&Pen); // 黑い ペンを iM 択 
pDC->MoveTo(x - dx, y - dy) ; // <x-dx. y-dy) から 

pDC->LineTo(x + dx, y + dy) ; // (x+dx. y+dx) へ 直線を 引く 

pDC->Select0biect(p01dPen) ; 



void CMenuTestView: :OnDraw(CDC* pDC) 

{ 

CRect rect; 
int x, y; 

GetClientRect (&rect) ; 

x = rect. right / 2; // ビュー ウィンドウの 中心を 得る 

y = rect. bottom / 2; 



myCircle(pDC, x, y, 140, LTGRAY.BRUSH) ; //肋 

myCircle(pDC, x - 50， y - 20， 30, WHITE-BRUSH); // 右の 白目 

myCircle(pDC, x + 50， y - 20， 30, WHITE-BRUSH); // 左の 白目 

myCircle(pDC, x - 50 + RtEyePos, y - 20, 20, BLACK-BRUSH); " 右の 播 
myCircle(pDC, x + 50 + LtEyePos, y - 20, 20， BLACK-BRUSH); " 左の 目 《 
myLine(pDC, x - 50, y - 80, 30, BrowPos, BrowWidth) ; // 右の 眉毛 

myLine(pDC, x + 50, y - 80, -30, BrowPos, BrowWidth) ; // 左の 眉毛 

rayLine(pDC, x - 40, y + 70, 40, MouthPos, 3); // ロの 右 半分 

myLine(pDC, x + 40, y + 70, -40, MouthPos, 3); // ロの 左 半分 



Ai •初は 「にっこりした 丨丨 （MouthPos= 10)J と 「む すっとした 丨丨 （MouthPos = -10)」 のど 
ちらかを 選ぶ ような メニューを 冬え ます。 丨| 標は図 2-9 のよう な メニューです。 

それでは、 Developer Studio から メニュー エディタの ウィンドウを 開いて ください。 

メニュー バーの イ丨 •端に ある 宁丨 '丨 の叫灼 形は ニュー アイテム ボックスと いって、 新しい メ 
ニュー 项 II は、 この 位时に 作成す る ことにな ります。 とりあえず、 ニュー アイテム ボック 
スを マウスで ダブル クリックして ください 。すると、 図 2-10 のよう な プロパティ ウィン 
ドウが 表示され ます。 

プロ パ テイ ウインドウの [キヤ プシ ョン] ボックスでは、 メニューの キャプション 文卞 列を 
指定し ます 。ここでは 「LI 元の 形」 と人ノ J しましょう 〇 すると メニュー エディタの メニュー 
にも、 M じ 文 卞 列が 衣 示されます。 
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[口元の 形] メニューと それぞれの 表示 図形 
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キャプション】 に 入力した 文字列が 
《ニューに 表示され る 

「口元の 形 J という キャプションを 入力した ところ 
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トーの 指定を 穴め る ことができます 〇 アクセス キーとは 
> る： Alt +汗 立の 1 义卞 のこと で、 アクセス キーを 押 
P クリックす るのと M じ 意味を 持ちます。 
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図 2-12 アクセス キーを 含む キャプション 指定と、 その実 際の メニュー 表示 



アクセス キーを 指记 する には、 「& [アクセス キー]」 という 文亇を 穴め てキ 
を 人力し ます。 「丨丨圯 の 形 （& K )」 という キャプションを 指定す ると、 この メニ 
セス キーは | A 丨丨！ + [ K になります 。 ま たこの ように アクセス キー 指定を キャブ 
ると、 灾際の メニューでは 「& K 」 ではなく ド 線が 付いた 「幻 が 衣/ され まっ 
トップレベルの メニュー 项|丨 を 作成す ると、 そのす ぐ 下に ニュー アイテム 汗 

ニ プルダウン メニュー 项丨 I を 作成し ます。 ここでは [にっ 
2 つの メニュー tfill を 作りましょう 。作成 力 •法は トップ 
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図 2-14 キャ フシ ヨンの ほかに メニュー ID も 指定す る 

これらの メニュー 埙丨| では、 さきほどの トップ メニューと 饵 なり、 キャプションの ほかに 
ズジ ェクト ID も 指定す る必 欢 があります > メニュー 识丨丨 を クリック すると、 COMMAND 
ン セージと いう メッセージが 発 し、 その メニュー 拟丨| の才 ブジェク 卜 IL) を 伴って ア 
リ ケー シ ョンに 送られます。 アプリケーション はこの オブジェクト II) を 兄て、 どの メ 
：! •一項 目が 選択され たの かを 利 断して、 リ 5 行 する 関数を 決定し ます 0 
t ブジェク ト ID の 名前は あとで ClassWizard でも 使われる ので、 メニュー 功丨1 が 選択 さ 
~こ ときに 行う 動作が わかる ようにして おく ことを お勧めし ます D ここでは: にっこり する; 
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メニューに 「 ID_MOUTH_SMILE 」、 [む すっとす る] メニューに 「 ID_MOUTH_ANGRY 」 
という 名前を 付けて おきましょう 。リソース エディタは 指定され た ID 名に 適当な 整数 侦 
を 割り当て、 それを Resource.h に 記録し ます 0 
仏 •後に （灾 際には いつでも よいが） メニューの 妆び 順を 幣 えます 。各 メニュー fl ： iH は マウ 
スで ドラッグ する ことにより、 位 敗を 向丨 | 丨に 変える ことができます。 Windows アプリ ケー 
シ ヨンでは 通常 [ファイル] メニューは 一推 左、 [ヘルプ] メニューは 一# 右と いう 惯 習が 
あるので、 MenuTest ブロ グラムで も その 例に ならう ことにします。 




図 2-15 メニューの 順番を B えたと ころ 

リソース エディタを 使 川しての メニューを 追加す る 作 袋は 以上で 終わりです。 ここまで 
が、 工程の 約半分。 あとの 仕垠は ClassWizard の 受け持ちになります 0 

2.4 メッセージ 八ン ドラの 記述 

ここからは メニュー ガ (丨丨 を 選択した ときに 発/ k する メッセージを 処理す るた めの メッセ 一 
ジ ハンドラを Class Wizard を 利 川して 作成す る ことが 生 な 作 菜と なって きます。 

ClassWizard を 起動す るには、 メニューから [表 ポ] - [ClassWizard] を 選択す るか、 あ 
るいは 丨 Ctrl j + 丨 w| を 押します。 classWizard が 起動す ると、 図 2-16 のよう な ダイアログ 
ボックスが 衣 示されます。 

この ダイアログ ボックスで [にっこり する] メニューを 選択す ると ほほ 笑む ような メッセ 一 
ジ ハンドラを 作ります 〇 まず ClassWizard の [クラス％] コンボ ボックスで、 [にっこりす 
る] メニューを クリックした ときに 発， 丨 •: する COMMAND メッセージの 受け T •となる クラ 
スを 指定し ます。 この メニューが 選択され ると クライアント 領域に 描かれた 顔の 表情が 変 
イ匕 する （冉 描丨由 i される） という ことは、 この メッセージは ビュー クラス （CMenuTestView 
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V •耆 Wnrtof 



I W I | 

図 2-16 ClassWizard 

クラス） の オブジェクトが 処理を する 必 贤 が あると いう ことです よって、 ここでは クラス 
名には 「CMenuTestView J を 指定す るの がよ いでし ょう 0 

クラスを 指记 すると [才 ブジェク 卜 II )] リスト ボックスに、 その クラスの オブジェクト 
に メッセージを 送る ことができる オブジェクト II ) の？:!; が 衣 小され ます 。ここでは [にっ 
こりす る] メニューが メッセージの 送り f なので、 し SMILE 」 を 選択し ます 
なお、 リストの 先 頒 には 受け f •の クラス 名 （ CMenuTesiView ) と M じ ものが 衣/ されて い 
ますが、 これは オブジェクト II ) が 必要ない メッセージ （たとえば WM _ PAINT ) と コード 
を 結び付ける 坳 介に 迸択 します。 



[CMenuTeslView] 



【ID MOUTH SMILE 】 




図 2-17 [クラス 名] と [オブジェ ク卜 ID ] を 指定した 



Windows の メッセージには、 メッセージの 名前 だけ 知れば 总 味が わかる ものと、 送り 
f •が 誰な のか 調べない と 対処の しようがな いものの 2 楝類 があります 。たとえば 、 「iihiifii 
を 描きれ せ」 という 立 味の WM_PAINT メッセージは 丨 ft •行の 例で、 この メッセージを 受け 
取った ウインドウは、 それが どこから 送られて きた ものだろう と、 かまわず 丨 丨丨丨 丨丨 〖丨丨 を 描き め: 
せ ばよ いわけです 。一力、 メニュー 项丨丨 が 発する メッセージは COMMAND メッセージと 
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呼ばれ、 後者に 诚 します 。ウィンドウは、 多くの メニュー 埙 目から 同じ COMMAND メッ 
セージを 受け取り ますが、 これ だけでは、 どの オブジェクトが どんな n 的で この メッセ 一 
ジを 発した のかは わかりません 。そのため 、 COMMAND メッセージには、 その 送り手を 
特记 する ための 才 ブジェク ト ID が 付いて くるので す。 そして、 ウィンドウは、 この id を 
もとに COMMAND メッセージ にどう 反応 すれば よい か 判断す るので す。 

メッセージの 受け手と なる クラス 名と、 送り手の オブジェクト ID が 決まる と、 [メッ 
セージ] の 欄に 才 ブジェク 卜が 送り出す ことができる メッセージの •ね: が 表示され ます。 メ 
ニューが 送り手の 場合は、 送り出す ことができる メッセージは 表 2-1 に 示す 2 M 類し か あ 
りません。 



メニューが 送出で きる メッセージ 


メッセージの 意味 


COMMAND 


メニューが 選択された 


UPDATE.COMMAND.UI 


インター フ ヱ イス 更新を 通知す る 



表 2-1 メニューが 送る ことができる メッセージ 



メニューが 選択され たこと を ビュー 才 ブジェク 卜に f ム •え るのは COMMAND メッセージ 
ですから、 「 COMMAND 」 を 選択し ます 。なお UPDATE_COMMANLUJI メッセージに 
ついては 後述し ます 。次に メッセージを 処观 する 間数 （メッセージ ハンドラ） の 定義を 行う 
ため、 <閲 数の 氾 加〉 ボタンを クリック します。 すると 関数 名を 指定す る 図 2-18 のよう 
な ダイアログ ボックスが 開きます。 




' ノハ 15細 [名 吵 



OK 



メ —ン COMMAND 
わ々/ 0ト n> ID-MOUTH 



4 ^ 



メンバ W « 名が 決まったら 
クリック 



図 2-18 [メンバ 関数の 追加] ダイアログ ボックス 



関数 名は 「 On 」 で 始まり、 適当な 文字列が 続きます。 ClassWizard が 示して くれる 名前 
(ここでは OnMouthSmile ) を、 そのまま 利⑴ しても いいでしょう。 <〇 K > ボタンを クリッ 
ク すると、 指 足した 名丨 •丨 ij •の メッセージ ハンドラが [メンバ 閲 数] の擱に 沿 加され、 叫 時に 
メッセージ ハンドラの スケルトンが 作成され、 ファイルに 丨丨 叩き込まれます。 

[メンバ 問 数] の リス 卜から、 今 作成した メッセージ ハンドラ （〇 n M 〇 u thSmile ) を マウ 
スで 選択し、 < コード 褊災 > ボタンを クリック すると、 エディタが 起動して メッセージ ハ 
ン ドラの 位! W に カーソルが 移動し、 リス 卜 2-3 のよう な 問 数が 衣り •くされます。 
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図 2-19 [メンバ 関数] に メニューの メッセージ ハンドラが 追 Ml された 



リス 卜 2-3 [につ こり] メニューの メッセ一 ジ八ン ドラの スケルトン （ MenuTestView . cpp ) 

void CMenuTestView: :OnMouthSmile() 

{ 

// TODO : この 位！ ■に コマンド ハンドラ 用の コードを 追加して ください 

} 



COMMAND メッセージを 受け とった ビュー オブジェクトは、 付 城す る オブジェクト ID 
を 見て、 それが [にっこり する] メニューから 送られて きた ことを 知り、 この OnMouthSmile 
メッセージ ハンドラを 突 行し ます。 

ここから あとは、 ブロ グラマで ある あなた 0 身の 受け持ちです。 といっても、 もう ほと 
んど什 は 残って いません。 丨丨の 位 沢を 表す パラメ 一夕を 変えて、 クライアント 領域を 更 
新す る だけ 。たった 2 行、 リス 卜 2-4 のように ブロ グラムを 杏き 直せば オーケーです。 

リスト 2-4 修正 後の メッセージ ハンドラ （ MenuTestView . cpp ) 

void CMenuTestView: : OnMouthSmileO // 修正 後の メッセージ ハンドラ 
{ 

MouthPos = 10; // ロの 竑を 基準 線から 10 ドット 上げる 

InvalidateRect (NULL, FALSE); // ウインドウを 描き 直す 



InvalidateRect 関数は、 CWnd クラスの メンバ 間数で、 ウィンドウの 表示 内容を 更新す 
るよう システムに 要求し ます 0 なお 上記の 引数は 「全 ウィンドウ 更新、 竹读消 去な し」 を 意 
味し ます （詳しくは オンラインマニュアルの 「MFC リファレンス」 を 参照の こと）。 ここで 
は 操作 対象を 指定して いません が、 これは 「this->InvalidateRect(NULL.FALSE)」 とみ 
なされ、 メッセージ ハンドラを 实 行して いる ビュー オブジェクト に対して InvalidateRect 
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閲 数が 突 行され ます。 これに よって、 ビュー オブジェクトの クライアント 領域が! ii 新され、 
CMenuTestView::OnDraw 関数が 実行され ます 0 

という わけで、 ようやく [にっこり する] メニューの メッセージ ハンドラ 力？ 完成し ました 〇 
M 様の T ••順で、 [む すっとす る] メニューの メッセージ ハンドラ CMenuTestView::OnM()uth 
Angry 問 数 も 作成して みて ください。 今度は 表 2-2 に ボすデ 一夕を 指定 すれば よい わけで 
す。 図 2-20 に、 WizardBar を 利 州した メッセージ ハンドラの 作成 方法を 示します し 



I 



クラス 名 


CMenuTestView 


オブジェクト ID 


ID.MOUTH.ANGRY 


メッセージ | 


COMMAND 


関数 名 


OnMouthAngry 



ID-MOUTHJ\NGRY が 発生す る COMMAND メッセージの メッセ 一 i 



-K 4 < ；\^ 霧^ 翁^^^^^^ 







4. lOnMou 丨 hAngryJ である ことを « 找 し、 
| <OK > ボタンを クリック 




図 2-20 WizardBar による メッセージ ハンドラの 作成 
OnMouthAngry 関数は リス 卜 2-5 のように 記述して ください c 



リス 卜 2-5 [ むすつ とする ] メニューの メッセージ ハンドラ （ MenuTestView.cpp) 
void CMenuTestView: :0nMouthAngrv() 

MouthPos = -10; // 口の端を 基準 線から 10 K ッ卜 下げる 

InvalidateRect (NULL, FALSE); // ウィンドウを 描き 直す 
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2 つの メッセージ ハンドラの 作成が 終わったら、 プロジェクトを コンパイルして 実行し 
てみ ましよう 。[口元の 形] メニューを 選択す ると プルダウン メニューが 衣 示される こと、 
そして [にっこり する] や [む すっとす る] を 選択す ると、 それに 応じて 丨丨 元の 形が 変わる 
ことを 確認して ください （図 2-21 )〇 




図 2-21 につ こりした ところ 



2.5 メニューの 付加 機能 

前節で 作成した メニューは、 もっとも 基本的な 形の もので したが、 Wi 丨 idows の メニュー 
では、 以下に 示す ような いろいろな 機能を 利用す る ことができます。 この 節では、 これら 
の 機能を 使いながら 顔に いろいろな 表情を 付けて いくこと にします。 

♦チェック マークを 表示す る 

♦状況によって 動作を 土 める （メニューの 有効 化/無効 化) 

•シヨ一卜 カット キーを 定在 する 



籲 チェック マークを 追加す る 

まず チェック マークの 利⑴ 例と して、 MenuTest プロジェクトに 図 2-22 に >j •くす メニュー 
を 追加して みましょう。 





2.5 メニューの 付加 機能 



133 




図 2-22 [目の 向き] メニュー とその 表示 図形 



メニューの 作成 

この メニューは CMenuTestView :: OnDraw 関数が 表示す る H ゼの 位 厥を 変えます 〇 ブ 
ル ダウン メニューの， 1 つの 顶 丨| によって、 ノ丨 •: イ丨 •の || それぞれ について 叫 きを 指' 上します。 
そして 現在の 丨丨の 叫きと •致す る メニュー 頊丨丨 には、 チェック マークを 衣 示します。 

それでは メニュー エディタを 起勋 して、 各 メニュー 项 II に 表 2-3 の キヤ ブシ ヨンと メ 
ニュー ID を 設定して ください。 



キャプション 


メニュー ID 


目の 向き （&M) | 


なし （トップ メニュー） 


右目が 右を 向く 丨 


ID.RIGHT.EYE.RIGHT 


右目が 左を 向く | 


ID_RIGHT_EYE.LEFT 


左目が 右を 向く | 


ID.LEFT.EYE.RIGHT 


左目が 左を 向く | 


ID_LEFT-EYE-LEFT 



表 2-3 メニュー 項目と その ID 



プルダウン メニューの 2 つ II の頌 II と 3 つ 丨丨の 項 II の 問には、 メニューを やすくす る 
ため、 セ パレー 夕 （ K 切り 線） を 人れ ましょう。 f •順は 非常に 簡中 .です。 まず、 ニュー アイ 
テム ボックスを セ パレー 夕を 神人す る 位阀に 移動して、 ニュー アイテム ボックスが 選択 さ 
れ ている 状態で、 ブロ パ テイ ボックスの [セ パレー タ] を チェック します 。すると、 ニュー 
アイテム ボックスの 位厲に セ パレ一夕が 追加され ます （図 2-23) 0 

メニューが 完成したら、 ClassWizard を 起動して ください 。そして 前節と 间 様に、 4 つ 
の メニューの COMMAND メッセージ に対する メッセージ ハンドラを 作成し ます 。メッ 
セージ ハンドラ 名と ClassWizard で 指定す る 各 要素の 対応は 表 2-4 に 示します。 です が、 
ClassWizard をい ちいち 起動して 、オブジェクト ID を 指定して、 …… というの が而 倒く 
さいと いう 人は、 WizardBar を 使用しても よいで しょう。 





目の 向きを 変更す る メッセ一 ジ八ン ドラ （ MenuTestView . cpp ) 




void CMenuTestView: :OnLeftEyeLeft () 



LtEyePos = 10; 

InvalidateRect (NULL, FALSE); 

} 
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チェック マークを 付ける には？ 

これで、 メニューの 甚本 動作 部分が' 完成し ましたが、 本題は ここから です。 この メニュー 
に チェック マークを 表示させる には どう すれば よいで しよう か？ 

その 答は、 メニューが 送り出す ことので きる もう 1 つの メッセージ、 UPDATE_COMMA 
ND_UI を 利用す る ことです 〇 UPDATE—COMMANDOJI メッセージは、 メニュー や ッー 
ルバ 一な どの ユーザー インター フヱ イスが 何ら かの 変化を おこす 直前に 生じます 0 

たとえば プルダウン メニューが 表示され ると き、 それぞれの ブルダ ウン メニュー 項目は、 
_ r 曲に 姿を 現す 直前に UPDATE _ COMMAND_UI メッセージを 発生し ます 。また、 この 
メッセージが 送られる とき、 それぞれの メニュー 项 H は 分 内分への ポインタ も 同時に 送 
り 出します 〇 UPDATE_COMMANDJJI メッセージの メッセージ ハンドラでは、 渡され 
た ポインタを 介して 送り手に アクセスし、 その 状態を 変更す る ことができます 。メニュー 
に チェック マークを 付ける 場合 も、 このし くみを 利用し ます。 

実際に、 [右目が 右を 向く] メニューに チヱ ック マークを 表示 させて みまし よう。 まず 表 2-5 
に 示す 指定に 従って、 UPDATE _ COMMAND 〇 JI メッセージ ハンドラの スケルトンを 作り 
ます 〇 UPDATE _ COMMAND _ UI の 場合は、 メッセージ ハンドラの 間数 名は 「 OnUpdate 」 
で 始まる ことに 注: & してく ださい 0 



クラス 名 


CMenuTestView 


オブジェクト ID 


ID.RIGHT.EYE.RIGHT 


メッセージ 


UPDATE.COMMAND.UI 


関数 名 


OnUpdateRightEyeRight 



表 2-5 チェック マークを 表示す る メッセ一 ジ八ン ドラの 指定 



作成され る メッセージ ハンドラの スケルトンは リス 卜 2-7 のよう な ものになります 0 
COMMAND メッセージの メッセ 一 ジノ、 ン ドラと 與 なり、 こちらは pCmdUI という 引数を 
持って いる ことに 注意して ください。 

リス 卜 2-7 UPDATE_COMMAND_UI メッセージ 八ン ドラの スケルトン （ MenuTestView.cpp) 

void CMenuTestView: :OnUpdateRightEyeRight (CCmdUI* pCmdUI) 

{ 

// TODO: この 位置に command update UI ハンドラ 用の コードを 追加して ください 




引数 pCmdUI は、 メッセージの 送り手 （ここでは [右目が 右を 向く] メニュー） を 示す も 
ので、 CCmdUI クラスの オブジェクトへの ポインタです 〇 CCmdUI クラスは、 メニュー 
と ツール バーな どの 種類が 異なる オブジェクトを 統一的に 扱える ようにす るた めの クラス 
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です。 

pCmdUI が 指す メニューに チェック マークを 付ける には、 CCmdUI :: SetCheck 閲 数を 使 
います 。この 関数は リ丨 数を 1 つ 持ち、 その 侦 が 1 なら メニューを 「チェック ON 」 の 状態と 
し、 0 なら 「チェック OFF 」 とします メニューが 衣ボ される ときには、 この, & 逛 状態に 
よって、 チェック マークを 付ける かどう かが 決まります。 

[“1 丨がイ i を 叫く] メニューに チェック マークを 付ける メッセージ ハンドラを リス 卜 2-8 
に/ ji します 。ほかの メニューに チェック マークを 付ける 垛合 も、 M 様な メッセージ ハンド 
ラを 作れば よい わけです: > メッセージ ハンドラの 指记は 表 2-6 にポ します。 



クラス 名 


オブジ ヱ クト名 


メッセージ 


メッセージ ハンドラ 


CMenuTestView 


ID.RIGHT.EYE.RIGHT 


UPDATE.COMMAND.UI 


OnUpdateRightEyeRight 


CMenuTestView 


— 1 

ID.RIGHT.EYE.LEFT 


UPDATE.COMMAND.UI 


OnUpdateRightEyeLeft 


CMenuTestView 


— — i h 

ID.LEFT.EYE.RIGHT 


UPDATE.COMMAND.UI 


OnllpdateLeftEyeRight 


CMenuTestView 


ID.LEFT.EYE.LEFT 


UPDATE.COMMAND.UI 


OnUpdateLeftEyeLeft 



表 2-6 チェック マークを 付ける ための メッセージ ハンドラ 



リス 卜 2-8 UPDATE _ COMMAND_UI メッセージの ハンドラ （ MenuTestView . cpp ) 

void CMenuTestView: :OnUpdateRightEyeRight(CCmdUI* pCmdUI) 

{ 

pCmdUI->SetCheck((RtEyePos < 0) ? 1 •• 0); "RtEyePos<0 なら チェック 

> 

void CMenuTestView: :OnUpdateRightEyeLeft(CCmdUI* pCmdUI) 

{ 

pCradUI->SetCheck((RtEyePos>0) ? 1 : 0) ; // RtEyePos>0 なら チェック 

} 

void CMenuTestView: :OnUpdateLeftEyeRight(CCmdUI* pCmdUI) 

{ 

pCmdUI->SetCheck((LtEyePos<0) ? 1 : 0) ； // LtEyePosCO なら チェック 

} 

void CMenuTestView: :OnUpdateLeftEyeLeft(CCmdUI* pCmdUI) 

{ 

pCmdUI->SetCheck((LtEyePos>0) ? 1 : 0) ； // LtEyePos>0 なら チェック 



* 1 状態が 2 とぃう こと も あり f ! f る <3 ステート ボタンの 坳 ぐい 




2.5 メニューの 付加 機能 
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_ メニューの 無効 化と シヨ一卜 カット キー および サブ メ ニ ューの 追加 

さて ここで、 MenuTest にもう 1 つ プルダウン メニューを 追加す る ことにし ましよう。 
今度は メニューの イ丨 •効 化 無効 化の 制御と、 ショートカット キー) ii 衣の 火 例です 0 

この メニューは C\lenuTest\iew::0nDraw 閲 数が 衣ボ する 的 毛の i &'/ U を 変 1 ii する もの 
で、 構成は 図 2-24 のようになります 




フ バル<£〉 口元 (施 目 <^(沙 餍毛 © 



cm*u 

層を 下げる 似 CtrhD 




図 2-24 [眉毛] メニュー 

[VI を丨 •.げ る] メニューを 選択す ると、 選択す る ごとに VI の 端が 少しずつ 上がって いき、 
[VI を ドげ る] メニューを 逍択 すると、 その 逆に Vi の 端が 少しずつ ド がって いきます 。どち 
らの メニュー も、 VI の 位 的が 決められた 吸 度に 述す ると、 それ 以上 迸択 できない ように 無 
効 化されます。 

さらに [Vi •を I ••げ る] メニューには I ^ D + u 、 [VI を ドげ る] メニューには ctr し + D 
という ショートカット キーを) U 在し ましょう ショートカット キーは、 アクセス キーと 似 
て汽 なる もので、 これを 使えば、 メニュー 项丨丨 が 両面に 衣ボ されて いなくても それを め: 接 
選択す る ことができます。 アクセス キーの 垛介 はいちい ち メニューを 開かなければ 利 川で 
きず、 たとえば [丨丨 it ] - [丨丨 •丨 を丨 •.げ る] を 選択す るには、 g で mt ] の プル ダウ 
ン メニューを 衣ボ し、 そこで さらに 「 Alt — +0 ( または 中. に且） を 押す 必要が あります。 
しかし ショートカット キーを 使えば、 ctn+ 互-発で、 いつでも [VI を丨 ••げ る] メニュー 
を 選択で きます。 

[VI の 太 さ] という メニューでは、 サブメニューを 使って 丨丨 •! の 太 さを 選択す るよう にして 
みました。 



138 



2 メニューを 使って みよう 



キャプション 


ID 


眉毛 (& G ) 


なし 


眉を 上げる （& U )¥ tCtrl + U 


ID . BR 0 W.UP 


眉を 下げる （& D )¥ tCtrl+D 


ID . BROW.DOWN 


眉の 太 さ 


なし 



表 2-7 [屬 毛] メニューの キャプションと メニュー ID 



例によって メニュー エディタを 起動し、 各 メニュー 項目に 表 2-7 の キャプションと メ 
ニ ュー ID を 与えて いきます 。なお キャプション 中の 「¥t」 は TAB コードを 意味し ます。 
「¥t」 を キャ ブシ ョン 中に 含む と ショートカット キーの 表示を メニュー 右側に きれいに 揃え 
る ことができます。 

[眉の 太 さ] メニューでは サブメニューを 利用す るので、 ブロ パティ ボックスの [ボップ 
アツ ブ] を チェックして ください 。すると メニューの 横に サブメニュー 用の ニュー アイテム 
ボックスが 生じます （図 2-25) 0 



[ポップアップ】 を チ I ック すると. 
サブ アイテム 用の ニュー アイテム 
ボックスが 表示され る 



図 2-25 [ポップアップ] を チェックした ところ 
サブメニューには 表 2-8 の キャプションと メニュー ID を 与えます。 




キャプション 


ID 


1 卜':/ 卜 


ID . BR 0 W .1 


3 K ッ卜 


ID . BR 0 W .3 


8 卜':/ 卜 


ID . BR 0 W .8 



表 2-8 サブメニューの キャプションと メニュー id 



これで メニューの 外見は 完成し ました。 次に ショートカット キーの 定義を 行います。 
ショートカット キーの 定義を 行う には、 まず ワーク スペース ウィンドウの [ Res〇urce Vi ew ] 
ページで [Accelerator] を ダブル クリックして ください （ショートカット キーは 別名 「アク 
セラ レー 夕」 ともいう ）〇 すると、 リソース ブラウザの 右の 欄に 「 IDR-MAINFRAME 」 と 






図 2-26 ショー 卜 カツ 卜 キーの 一 K 



いう ID が 衣 示される ので、 これを ダブル クリック します。 アクセ ラレータ テーブル エディ 
夕が 起勋 し、 现心 •: 设记 されて いる ショートカット キーの- 览 が 表示され ます （図 2-26>。 

このと き 衣 示される ショ一 ト カット キーは、 AppWizard が スケルトンを 作成した 時点 
で 走義 した もので、 MenuTest プロジェクトでは 使用し ません から、 [5^1 を 何度か 押す 
か、 あるいは 削除したい 顶丨| を 心 •クリックして ショートカット メニューから [切り取り] を 
選択す るな どして、 すべて 削除して しまっても かまいません （プロジェクトに よっては 初 
期 設定を そのまま 利 叫す る こと も あり、 いつでも 削除で きる わけでは ない）。 

次に、 アク セラ レー 夕 テーブル エディ 夕の 仟 盘 の位汧 をれ クリックして ショートカット 
メニューから [アク セ ラレータの 新規 作成] を 選んで、 ショートカット キーの 設定を 行う ブ 
ロ パ ティ ボックスを 開きます 。まず [約を 上げる] メニューに j QrlW という ショート 
カット キーを 割り 里て てみ ましょう。 

[ID] ボックスには、 ショートカット キーに 対応す る メニュー 顶13 の ID を 指定し ます。 こ 
こでは [V 丨を丨 ••げ る] メニューの ID、 すなわち [II)_BROW_UP] を 人力 すれば よい わけで 



1 •定 II されて いた ショートカット 

削除して 、シヨ一卜 カット メニューから 
[アク セ ラレータの 新規 作成】 を iM 択 



2. 【 ID — BROW - UP 】 を i « 択 

3. クリック 



4 •ン ヨー 卜 カツ 





図 2-27 シヨ一卜 カツ 卜 キーの 設定 
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2 メニューを 使って みよう 



す 。次に く キー タイ ビング 登録 > ボタンを クリック すると、 ショー 卜 カット キーの 入力を 
促す ダイアログ ボックスが 開きます から、 そこで + ® を 押してく ださい （図 2-27)。 

キーを 押す と 登録は 完了し、 次の ショートカット キー 定 在に 移る ことができます。 
いまと 丨 "1 様の 手順で、 [ VI を ドげ る] メニュー （ ID _ BROW _ DOWN ) に、 こが を 割 
り 当てて ください。 

ショ ート カッ トキ一には、 シフトキー （「 Shift ] 、 丨 Ctrl ]、 L ，]) + その他の キーの ほと 
ん どの 組み合わせが 利〗 ljuj ■能です。 Shift ] + 「 dtrP + X ’ のように、 极 数の シフトキーを 卜 J 
時に 押す こと もで きます 。文字 キー だけでは なく、 ファンクションキー や 力一ソル キー も 
使えます。 




ID.BROW.DOWN Ctrl ♦ D VIRTKEY 

ID-BROW-UP Ctrl ♦ U VIRTKEY 




図 2-28 新しく 2 つの シヨ 一 卜 カツ 卜 キーを 定義した ところ 

シヨ 一 卜 カツ 卜 キーの 設逛が 終 r したら、 Class Wizard を 起動し ます。 COMMAND メッ 
セージを 発生す る 5 つの メニューには、 それぞれ リス 卜 2-9 に 示す メッセージ ハンドラを 
作成し ます。 メッセージ ハンドラと ClassWizard ダイアログ ボックスの 各 瑣丨丨 との 対応は 
表 2-9 に 示します。 











CMenuTestView 

_ ■■丨 ■ 


ID.BROW.UP 


COMMAND 


OnBrowUp 


CMenuTestView 

■ ■ i 


ID-BROW-DOWN 


COMMAND 


OnBrowDown 


CMenuTestView 


ID_BROW_1 1 


COMMAND 


OnBrowl 


■ 

CMenuTestView 

* *' — ■ - 1 


ID.BROW.3 


COMMAND 1 


"" — " - ■ 

OnBrow3 


CMenuTestView 


ID.BROW.8 


COMMAND 


■ 

OnBrow8 



表 2-9 眉毛に 関係す る メッセ一 ジ八ン ドラ 





void CMenuTestView: :0nBrowUp() 

{ 

BrowPos += 10; 

InvalidateRect (NULL , FALSE) ; 



void CMenuTestView: :0nBrowDown() 

{ 

BrowPos -= 10; 

InvalidateRect (NULL , FALSE) ; 



void CMenuTestView: :0nBrowl() 

{ 

BrowWidth = 1; 
InvalidateRect (NULL, FALSE) 



void CMenuTestView: :0nBrow3() 

{ 

BrowWidth = 3; 
InvalidateRect (NULL , FALSE) 



void CMenuTestView: :0nBrow8() 

{ 

BrowWidth = 8; 
InvalidateRect (NULL , FALSE) 



一の 付加 機能 



( MenuTestView.cpp) 




一の [1 ドット]、 [3 ドット]、 [8 ドッ 

ような UPDATE-COMMANLLUI メ 
项 H を チェックす るよう にします 。メ 



CMenuTestView 


ID.BROW.1 


UPDATE.COMMAND.i 


CMenuTestView 


ID.BROW.3 


UPDATE.COMMAND. 


CMenuTestView 


ID.BROW.8 


UPDATE.COMMAND. 



眉毛の 太 さに チ 



ークを 付ける メ 








一を 使って みよう 
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リスト 2-10 UPDATE_C 〇 MMAND_UI メッセージ ハンドラ （ MenuTestView.cpp) 



void CMenuTestView: :OnUpdateBrowl(CCmdUI* pCmdUI) 

{ 

pCmdUI->SetCheck((BrowWidth == 1 ) ? 1 : 〇 ); // 眉の 太 さが i なら チェック 



void CMenuTestView: :0nUpdateBrow3(CCmdUI* pCmdUI) 

{ 

pCmdUI->SetCheck((BrowWidth == 3) ? 1 : 0 ); // 眉の 太 さが 3 なら チェック 



void CMenuTestView: :0nUpdateBrow8(CCmdUI* pCmdUI) 
pCmdUI->SetCheck((BrowWidth == 8) ? 1 : 0 ); // 眉の 太 さが 8 なら チェック 



また [VI を 上げる] と [VI を ドげ る] の 各 メニュー 项丨| について は、 UPDATF._COMMA 
ND_UI メッセ 一 ジノ、 ン ドラの 中で、 CCmdUhEmiblelW 数を 灾行 し、 イ j •効イ 匕， 無効 化の 制 
御を します （リス 卜 2-11>〇 この 問 数は 引数が TRUE のとき メニューを イ丨効 化し 、 FALSE 
のとき 無効 化します 。無 幼 化された メニュー 项丨丨 は 灰色の 义卞で 衣 示され、 迸択 する こと 
がで きなくなります。 



クラス 名 


オブジェクト 名 


メッセージ 


メッセージ ハンドラ 


CMenuTestView 


ID.BROW.UP 


UPDATE.COMMAND.UI 


OnUpdateBrowUp 


CMenuTestView 


ID.BROW.DOWN 


UPDATE.COMMAND.UI 




OnUpdateBrowDown 



表 2-11 メニューを 無効 化する メッセージ 八ン ドラ 



リス 卜 2-11 眉の 角度を 変更す るた めの UPDATE_COMMAND_UI メッセージ ハンドラ （ MenuTestView.cpp) 
void CMenuTestView: :OnUpdateBrowUp(CCmdUI* pCmdUI) 

pCmdUI->Enable((BrowPos < 20) ? TRUE : FALSE); // 眉の 位置が 20 以上なら 無効 化 



void CMenuTestView: :0nUpdateBrowDown(CCmdUI* pCmdUI) 
pCmdUI->Enable((BrowPos > -20) ? TRUE : FALSE); // 眉の 位置が - 20 以下なら 無効 化 









一の 付加 機能 




カット キー 
- も 、 f Ctrl 1 





ダイア □グ ボックスを 
3 使って みよう 



このな では DlgTest という プロジェクトを 作成しながら、 ダイアログ ボックスの 使い 力- 
に ついて 説明を します。 この プロジェクトは 丨 の MenuTest で メニューを 使って 行った 

操作を ダイアログ ボックスでの 操作に 的 き 換えた ものと 考えて ください 〇 DlgTest プ ロジェ 
クトの ソースは 付 W CD-ROM の 「 DlgTest 」 フォルダに 収めて あります 0 



3.1 スケルトンの 作成 

まず DlgTest プロジェクトの ド， 備 として、 AppWizard で スケルトンを 作成し、 丨 W ず?: 
と 丨"1 様な 顔 衣 ボル 一 チンを ill 加す ると ころまで 作衮を 進めます 。以下は その プロジェクト 
の 体 奴を まとめた ものです 0 

•ブロ ジ ヱクト 名 ： DlgTest 
參 アブリ ケー シ ヨンの タイプ ： SDI 
參 データベースの サポート： しない 
♦极合 ドキュメントの サポート： しない 
♦ ツール バー ステータス バー： なし 
♦印刷と 印刷 プレビュー： なし 
♦そのほか： デフ オルトの まま 

AppWizard の オプション 設定は、 MenuTest と M じく SDI 形式を 使い、 [ドッキング 
ツール バー] と [印刷 および 印刷 プレビュー] についても チェックを はずした 状態で スケル ト 
ンを 作ります 。次に リソース エディタを 使⑴ して、 メニュー バーを 作成し ます 〇 AppWizard 
が 生 •成した メニューは 、[ファイル] 一 [アブリ ケー シ ョンの 終了] と、 [ヘルプ] 一 [バー 
ジョン 情報 （ DlgTest )] だけ 残して あとは 削除し、 表 3-1 に 示す メニュー 瑣 H を メニュー 
バーに 迫 加し ます。 



3 ダイアログ ボックスを 使って みよう 



キャプション 


ID 


口元の 形 (& K ) 


ID . MENU.MOUTH 


目の 向き （& M ) 


ID . MENU.EYE 


眉毛 （& G ) 


ID _ MENU_BROW 



表 3-1 DlgTest プロジェクトの メニュー 投定 



せつ かくの ダイアログ ボックスの 利用 例です から、 ここでは ブルダ ウン メニューを まつ 
たく 使わない ことにし ましょう。 つまり、 メニュー バーに 表示され ている 頊 目を クリック 
すると、 COMMAND メッセージが 生じ、 その 結果 ダイアログ ボックスが 表示され るよう 
にします。 メニュー バーに 表示され る メニュー 項目に 閲 しては、 通常は ブロ パティ ボック 
スの [ボップ アップ] が チェックされ ています が、 この チェックを 取り除く と ブルダ ウン メ 
ニューが 表示され なくなり、 同時に ブロ パ ティ ボックスの [ID] ボックスが 荷 効に なって 
メニュー ID を 入力で きる ようになります。 メニュー ID を 持てる という ことは、 ここを ク 
リックす ると COMMAND メッセージが 生じる という ことです （囡 3-1) 〇 




図 3-1 [ポップアップ】 の チェックを はずした ところ 

ついでに [アブリ ケー シ ヨンの 終了] と [バージョン 悄報 （DlgTest)] も、 それぞれの ブ 
ル ダウン メニューから メニュー バーに ドラッグ & ドロップを 利用して 移して、 空に なった 
[フ アイ ル] と [ヘルプ] は 削除して しまいましょう 。敁終 的に メニュー バーは 図 3 一 2 のよ 
うになります。 



77ツ ク〜ン iXW 了 矽ロ兩 目 馨 毛 似 叫 

図 3-2 この プロジェクトの メニュー パー 

次に CDlgTestView::OnDraw 関数に、 「顔」 を 描く プログラムを 記述し ます。 これは 前 
節の MenuTest の CMenuTestView::OnDraw 間数と まったく 叫 じ 内容です から、 そちら 
を 参照して ください。 MenuTestView.cpp から コピー & ペーストして しまっても かまい ま 
せん。 






3.2 ダイアログ ボックスの 作成 



以 I •.で， 備 はおし まい 。次からは、 ダイアログ ボックスの 作成 手順と、 その 利用 力 •法を 
説明し ます。 



3.2 ダイアログ ボックスの 作成 



ダイアログ ボックスを 新規に 作成す るには、 メニューから [挿 人]- [リソース] を 選択し 
て [リソースの 挿 人] ダイアログ ボックスで [ Dialog ] を ダブル クリックす るか、 あるいは プ 
ロジェ クト ワーク スペース ウィンドウに [ ResourceView ] ページを 衣/ ji し、 次に [ Dialog ] 
フ ォルダを“ クリックして ショートカット メニューから [ Dialog の 神 •入] を 選択し ます。 す 
ると 図 3-3 のよう な ダイアログ エディタと コントロール パレットが 衣 示 $ れ ます、 






jDlf ?•••，•，• 



OlfT^uc WW® 
I •入© 




シヨ一卜 カット メニュ •の 

• 【 Dialog の裨 入】 を迸択 すると、 

f タか 間く 



□E 






FiltVi 







ダイアログ エティ タ 



コントロール パレ 



図 3-3 ダイアログ エディタと コン 卜 □一 ル パレ ッ卜 



ダイアログ ボックスは、 | •.台になる フレームと、 フレームの 丨 •に 妃丨 7( したいく つかの コ 
ン卜 ロールから 惝 成されます 。コントロールとは ユーザー インターフェイスの 部品と なる 
もので、 終 r を 確認す るた めの ダイアログ ボックスでは <0 K > ボタン や < キャンセル >ボ 
タンが そうです し、 そのほか にも さまざまな 神 類の コン 卜 ロールが あります。 

ダイアログ ボックスの サイズ や、 コントロールの 位 的と サイズは、 変史 したい 部分を マ 
ウスで ドラ ッグす る ことによって 「丨丨丨丨 に 変えられます D また コントロール や ダイアログ ボッ 
クスを ダブル クリック すると、 プロパティ ボックスが 衣ボ され、 キャプション や id が 設定 
できる ようになります。 新しい コン 卜 ロールを コントロール パレットで 選択し、 ダイア ロ 
グ ボックス I •.で マウスを ドラッグ する だけで 追加す る こと もで きます。 ダイアログ エディ 
夕を 利 川す ると、 このように コントロールを 妃 的して いく だけで、 ちょうど 貼り 絵 細 r で 
も 作る ような 感觉 で簡中 •に ダイアログ ボックスを 作成す る ことができます。 ダイアログ エ 
デ ィタの 詳しい 使い 力は、 ここでは 説明し きれません ので、 VisualC ++ の オンライン マ 



ニユ アルを 参照して ください。 

DlgTest プロジェクトでは、 4 神: 類の ダイアログ ボックスを 作ります。 まず 似 •初は、 プ 
ログ ラムの 終了 確認に 使う ダイアログ ボックスで、 <〇 K > ボタンと く キャンセル〉 ボタン 
を 備えた だけの 非常に シン ブルな ものです。 ダイアログ エディタが 敁 初に 衣ポ する デフ 才 
ルトの ダイアログ ボックスと 丨 hi じ 構成です から、 その ボタンの 位 沢 や サイズを 変更す る だ 
けで あっとい うまに 完成です （図 3-4 >。 




図 3-4 [終了しても よいです か？] ダイアログ ボックスの 完成 図 

<0 K > ボタンと く キャンセル > ボタンは、 プロパティの 変 史 は 必要ありません。 そして 
ダイアログ ボックス 诌 身の ブロ パ テイには、 図 3 _ 5 のように データを， 没定 します。 




図 3-5 [終了 確 ダイアログ ボックス （ IDD _ DLG _ EXIT ) の プロパティ 

ダイアログ ボックスの [キャ プシ ヨン] とは、 タイトル バーに 衣ボ される 文字列の ことで 
す 〇 [ ID ] には ダイアログ ボックスの リソース ID を指记 します 。ここは、 メニュー ID と 
同様に、 名前を 指定 すれば リソース エディタが ft 動的に 適 a な 侦を设 走して くれます。 こ 
の プロジェクトでは、 ダイアログ ボックスの ID 名は すべて 「 IDD _ DLG 」 で 始める ことに 
しました。 

[フ オン 卜 名] と [フォント サイズ] には、 ダイアログ ボックス 内で 使用す る フォントの 
名前と サイズが 表示され ています 。初期設定は MS P ゴシック フォントです が、 < フォン 
ト> ボタンを 押す と フォント 変 吏の ダイアログ ボックスが 開きます 。キャプション （黹に 
System フォントを 使用） 以外の すべての 文字は、 ここで 指定した フォントを; いて 表ボさ 
れ ます 。また ダイアログ ボックスの 中では、 [フォントの 幅の 1/4] を x 铀方 叫の 1 中 •位、 
[フォントの 尚 さの 1/8] を y 軸 力 ji 】 の 1 丨れ 位と する M さの 中. 位 （ダイアログ 艰位） が 使わ 
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れ ます 。ダイアログ ボックスの サイズ や、 コントロールの 位遛と サイズは、 すべて ダイア 
ログ! 位で 指定され るた め、 フォントの サイズを 変える と ダイアログ ボックス 全体の サイ 
ズも r 丨勋 的に それに 合わせて 調整され ます （図 3-6)。 





MSP ゴシック 9p 丨の壜 合 



MSP ゴシック 12p 丨の塌 合 



図 3-6 フォン 卜 サイズを 変更した ダイアログ ボックス 



X 嵴標と y 崦標 は、 ダイアログ ボックスの 衣ボ位 的を ダイアログ 中 •位で 衣した ものです 0 
ダイアログ ボックスの 親 ウィンドウの/ 丨 •: 丨 ••隅が、 丨 fi (点 （0• 0) にあたり ます 0 

3.3 ダイアログ ボックス クラスの 登録 

r!ij •々で 兄た ように、 メニュー エディ 夕で 作成した メニューは、 すぐに も ブロ グラムの 屮 
で 利 川で きました。 しかし ダイアログ ボックスの 場合は、 ダイアログ エディタで 梆 造を 決 
めた あとに もう 一代 # 残って います 。この ダイアログ ボックスを 扱うた めの 1 、 1 / 川の クラス 
の 定義です 。この 迫い は、 メニューが 中なる ウィンドウ 丨 ••の 部品 （コントロール） なのに 対 
し、 ダイアログ ボックスは 独立した ウィンドウ として 戈 現される からです。 •般に Visual 
C ++ では、 梆 造の 涔 なる ウィンドウ ごとに、 新しい クラスが 必敗 になります n 

ダイアログ エディタで 今 作成した ダイアログ ボックスの 仟总 の位胙 を“ クリックして、 
ショートカット メニューから [Class Wizard] を 選択す ると Class Wizard が 起動し ます。 ダ 
イア ログ ボックスを 選択して おいて、 メニューから [衣, ji ] - [ClassWizard] を 選択した 
り、 ツール バーの ClassWizard ボタンを クリックしたり、 あるいは、 ctri」+w を 押しても 
かまいません。 ClassWizard が 起動す ると、 [クラスの 追加] ウィンドウが 開きます 。ここ 
でく 新規 クラスの 作成〉 を 選択して く OK > ボタンを クリック すると、 ダイアログ エ ディ 
夕から ダイアログ ボックス ID などの データが 送り込まれ、 図 3-7 に 示す 設 记が犮 示され 
ます。 

[クラス 名] には 新しい クラスの 名前を 人力し ます。 このと き 名前の 先頭を 大文字の** C ” 
で 始める と、 MFC の 他の クラス 名との -rt 性が 保て、 ブロ グラムが 説み やすくなります。 
ここでは CEndDlg クラスと 名付けました 0 

ダイアログ ボックスの クラスは、 すべて CDialog クラスから 派 した もので なければ な 
りません。 そのため [基本 クラス] には [CDialog] を 指定す る わけです が •、ダイアログ エ ディ 
夕から ClassWizard を 起動した 場 介は、 この 欄には H 動的に CDialog が 選択され ます。 
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0 3-7 [クラスの 新規 作成】 ダイアログ ボックス 

[ダイアログ II )] には、 ダイアログ エディ 夕で 指定した ダイアログ ボックスの リソース 
id を 人力す る 必要が あります が、 これ も ダイアログ エディ 夕で 指定した リソース id で n 
動的に 设定 されます。 
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図 3-8 ファイル 名の 指定 

[ファイル] には、 [クラス 名] に 指定した ダイアログ ボックス クラスの 名前を もとに 適 
1 な 火 焚 ファイルの ファイル 名が 衣ボ されます 3 ヘッダ ファイルは ここに 衣 示されて いる 
欠 装 ファイルの 「•卬 p 」 の 部分が 「上」 に 変わった ものです 〇< 変 史> ボタンを クリック する 
と、 ヘッダ ファイルと 义装 ファイルの ファイル 名を プログラマが 指定す る こと も 可能です 
(図 3-8>〇 プログラマが 災焚 ファイル および ヘッダ ファイルの ファイル 名を 指定 するとき 
に、 すでに プロジェクトに 存 心: する ファイル 名を 指定した 場 介、 クラスの 定義と その実 装 
は 指) ii した ファイルの 仏 •後に 付け; jl されます 。ここでは Class Wizard が 表示した ファイル 
名を そのまま 使 川す る ことします。 

[才ー トメ ーシ ョン] では、 OLE オートメーション クライアント にこの クラスを 公開し 
たり、 この クラスの オブジェクトを クライアントが 作成で きる ように 指定し ますが、 ここ 
では OLE は 問 係ない ので [しない] を才ン にして おけば よいでしょう。 




3.3 ダイアログ ボックス クラスの 登録 



設定が すべて 終わったら、 <0 K > ボタンを クリック します。 すると リス 卜 3-1 と リス 
卜 3-2 に 示す 2 つの ファイルが 作成され 、プロジェクトに 追加され ます 0 

リスト 3-1 ヘッダー ファイル （ EndDIg . h ) 



#if !defined(AFX.ENDDLG.H__lCE 62927.2 EE5_11D2.ACD8_00A0247DB2AD.„INCLUDED.) 
#define AFX_ENDDLG_H._1CE 62927.2 EE 5.1102 _ACD8_00A0247DB2AD_.INCLUDED„ 

#if _MSC.VER > 1000 
#pragma once 

#endif // .MSC.VER > 1000 

// EndDIg.h : ヘッダ— ファイル 

// 

111111111111111111111111 111111111111111 

// CEndDlg ダイァログ 

class CEndDlg : public CDialog 

{ 

// コンスト ラ クシ ヨン 
public: 

CEndDlg (CWnd^ pParent = NULL); // 摞 準の コンストラクタ 

// ダイァログ データ 
//{{AFX.DATA (CEndDlg) 
enum { IDD = IDD.DLG.EXIT }; 

// メモ： ClassWizard はこの 位！ ■ に データ メンバを 追加し ます 0 
//}}AFX_DATA 



//オーバーラィド 

// ClassWizard は 仮想 関 « の オーバーライドを 生成し ます 0 

//{{AFX.VIRTUAL(CEndDlg) 

protected: 

virtual void DoDataExchange(CDataExchange* pDX) ; // DDX/DDV サポート 

//»AFX.VIRTUAL 

//インプリメンテーション 

protected: 

// 生成され た メッセージ マップ 関数 
//{{AFX.MSG (CEndDlg) 

// メモ： ClassWizard はこの 位 * に メンバ 関数を 追加し ます。 

//»AFX.MSG 
DECLARE.MESS AGE.MAP ( ) 

>； 

//{{AFX_INSERT_L0CATI0N» 

// Microsoft Visual C++ は 前行の 直前に 追加の 宣言を 挿入し ます。 

#endif//! defined(AFX_ENDDLG_H._lCE 62927.2 EE 5.1102 _ACD8_00A0247DB2AD__INCLUDED_) 
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リス 卜 3-2 インプリメント ファイル （ EndDIg . cpp ) 



// EndDlg.cpp : インプリメンテーション ファイル 

// 

#include "stdafx.h" 

#include "DlgTest.h" 

#include "EndDlg.h" 

#ifdef .DEBUG 
#define new DEBUG.NEW 
#undef THIS.FILE 

static char THIS_FILE[] = __FILE._; 

#endif 

11111111111111111111111111 1111111111111 

// CEndDlg ダイァログ 

CEndDlg: :CEndDlg(CWnd* pParent /*=NULL*/) 

: CDialog(CEndDlg: : IDD, pParent) 

//{{AFX_DATA.INIT(CEndDlg) 

// メモ - ClassWizard はこの 位* に マッピング 用の マクロを 追加 または 削除し ます 

//}>AFX_DATA.INIT 



void CEndDlg: :DoDataExchange(CDataExchange* pDX) 

{ 

CDialog: :DoDataExchange(pDX) ; 

//{{AFX.DATA.MAP (CEndDlg) 

// メモ - ClassWizard はこの 位 » に マッピング 用の マクロを 追加 または 削除し ます 
//}}AFX_DATA 一 MAP 



BEGIN.MESSAGE.MAP (CEndDlg , CDialog) 

//{{AFX_MSG_MAP(CEndDlg) 

// メモ - ClassWizard はこの 位 » に マッピング 用の マクロを 追加 または 削除し ます 。 

//»AFX_MSG.MAP 

END_MESSAGE_MAP() 

111111111111111111111111111111111111111 

// CEndDlg メッセージ ハンドラ 



CEndDlg クラスは CDialog クラスの 機能を ほとんど そのまま 受け継いだ だけの クラス 
です。 したがって、 EndDlg.cpp には 敁 初は 特笊 する ような コードは まったく 穴 まれて いま 
せん 〇 CEndDlg クラス 独 H の勋 作が 必 费 なと きは、 この EndDlg.cpp で メンバ 間数の オ一 
バー ライドを 行います。 




3.4 ダイアログ ボックスの 表示 



EndDlg.h には CEndDlg クラスの 定在が 記述され ています。 CEndDlg クラス 独 「I のメ 
ンバ 変数が 必要な 場合は、 この クラス 定義を 修 J 丨 •: します 。また プロジェクトの 他の フ アイ 
ル 中で CEndDlg クラスを 利 川す る 際には、 この EndDlg.h を インクルードし なければ な 
りません。 



3.4 ダイアログ ボックスの 表示 

CDialog クラスから 派 ル: した CEndDlg などの クラスには、 DoModal 間数と いう メンバ 
問 数が あり、 これを 利) I 丨 すれば 簡 中. に ダイアログ ボックスを 衣 示す る ことができます。 U- 
体 的な T •順は 次のと おりです 0 

CEndDlg dig; //CEndDIg クラスの オブジェクトを 定義す る 
mt retcode; 

retcode = dlg.DoModalO; //dig の DoModal 間数を 実行す る 

DoModal 間数を 欠 行す ると、 丨"1 一 ブロ グラム 内の 他の ウィンドウは アクセス イく丨 げ 能に な 
り、 衣： された ダイアログ ボックスに しか アクセスで きなくなります 。適 a な 操作を 行っ 
てから ダイアログ ボックスを m じる と、 D〇M〇dai 問 数は 終 r し、 返り 侦を 返します。 

このように アブリ ケー シ ョンの 他の 部分を-時 怜丨丨 •.させて 勋作 する ダイアログ ボックスを、 
モーダル （Modal) 形式と 呼びます 〇 Windows では、 このほかに モード レス （Modeless) 
形式と いって、 アプリケーションと 妆列 に勋 作す る ダイアログ ボックス も 利 JH する ことが 
できます が、 モード レス ダイアログ ボックスを 灾現 する ブロ グラムは 少 々複雑な ので、 小 
外 では 扱いません。 

DoModal 問 数の 返り 侦は ダイアログ ボックスの 終广 ステ一タスを 氺 します。 たとえば、 
<0K> ボタンを 押して 終了した 場合は IDOK、 < キャンセル > ボタンな らば IDCANCEL 
という 返り 侦に なります。 なお、 DoModal 関数に 任意の 返り 侦を 返させる 方法は 次 節で 説 
明し ます。 

それでは、 この CEndDlg クラスの ダイアログ ボックスを 利丨 U して、 ブロ グラムを 終 广 
するとき 、本当に 終 r してよ いか 確認を 求める 機能を DlgTest プロジェクトに 組み込んで 
みまし ょろ。 

[アプリケーションの 終 丫] メニューを 選択す ると、 ID_APP_EXIT という オブジェクト 
II) を 持つ COMMAND メッセージが 発生し ますから、 それを メッセージ ハンドラで 捕ま 
えます。 メッセージは アプリケーション クラス （CDlgTestApp クラス） で処邱 •すれば よい 
でしょう 。つまり ClassWizard で 表 3-2 に 示す 指定を して メッセージ ハンドラを 作成 すれ 
ばよ いわけです。 



3 ダイアログ ボックスを 使って みよう 



クラス 名 


CDIgTestApp 


オブジェクト ID 


ID.APP.EXIT 


メッセージ 


COMMAND 


関数 名 | 


OnAppExit 



表 3-2 [ 終了 ] メニューの メッセージ ハンドラの 指定 



ClassWizard が 出力した スケルトンは、 リス 卜 3-3 のように 変更し ます 。この 関数は、 表 
示した ダイアログ ボックスが < 0K > ボタンで 閉じられた 場合に 限り、 C Win AppxOnAppExit 
間数を 突 行して プログラムを 終了させます 〇 CEndDlg クラスを 利用す るた めには、 D1 
gTest.cpp に EndDlg.h を かならず インク ル一 ドして ください 0 



リス 卜 3-3 変更した CDIgTestApp::OnAppExit 閲数 （ DlgTest.cpp) 



#include "EndDlg.h" 

void CDlgTestApp: :OnAppExit() 

{ 

CEndDlg dig; 

if (dlg.DoModalO == IDOK) { 
CWinApp: :OnAppExit() ; 



✓/ かならず インクルード する こと 



が ダイアログ ボックスを 表示し 
ガ <OK> ボタンが 押されたら プログラムを 終える 
が <OK> ボタンが 押されな けれは イ 可 もしない 




図 3-9 断師 



なお、 この場合 EndDlg.cpp には まったく 手を 加える 必要はありません 0 







3.5 終了 ステータスを 知る には？ 



3.5 終了 ステータスを 知る には？ 

ダイアログ ボックスは、 丨 S (則と して アプリケーションとは 別個に！ FJj 作す る 独、 X した ウィ 
ン ドウです 。ダイアログ ボックスと、 その 丨 •.に rtiliW . された ボタンな どの コントロールは、 
•緒に なって m じた 丨 丨丨: 界を 作って いると いっても よいでしょう。 

たとえば、 前 C の MenuTest の坳 介、 メニュー 頊丨丨 を 選択す ると 選択され たメ 
ニュー 瑣 H を 反映す るよう に丨由 j 而を洱 描 丨 由 i してい ましたが、 このと き メニューが 発 屯 し 
た COMMAND メッセージは ビュー クラスの オブジェクトが 処邶 していました 。これは、 
ビュー クラスの 才 ブジェク 卜は メニューで 免卞 した メッセージを 受け取り、 処 列! する こと 
がで きたから でした 。•力 •、ダイアログ ボックス I •.の ボタンは BN_CLICKED メッセージ 
を 発 生 します が、 この メッセージを 受け取る ことができ るのは、 その ボタンを 所 イ丨 •してい 
る ダイアログ ボックス だけな のです* 1 0 ダイアログ ボックスで liiiil 〖丨 i に 変化を リ •える ような 
ボタンが 押されても、 丨山 丨丨〖丨丨 を W 描丨 叫す るは ずの ビュー オブジェクトは その ボタンが 允 卞 し 
た メッセージを 受け取る ことができません 。という ことは、 ダイアログ ボックスでの ユー 
ザ 一の 選択 結 米を 取 する ための W ら かの" 法が 必欢 だとい うこと です。 

ダイアログ ボックスから データを 取 作す るのに もっとも 简 中 •なん •法は、 前節で も いった 
ように、 DoModallW 数の 返り 侦 、すなわち ダイアログ ボックスの 終 / ステータスを 利 川 
する ことです 〇 DoModa 丨閲 数で 開始した ダイアログ ボックスは、 終 T するとき にかなら 
ず CI ) ialog :: Endl ) ialog 閲 数を 史行 します。 <() K > ボタンを クリックして ダイアログ ボッ 
クスを 閉 じた 場合は、 その メッセージ ハンドラ CDialog :: OnOKIW 数の 中で 、 EndDialog 
( II ) OK ) を 火 行して います。 その 結! ft として DoModallW 数は IDOK を 返す のです。 

これを 利 パ] すると、 <01<>ゃ< キャンセル > 以外の ボタンで も 押された かどう かが 简 
中. に 調べられます。 ここでは 図 3-10 のよう な ダイアログ ボックスで、 < にっこり >ボ 夕 
ンを クリック すると 丨由 lift 丨の 顔が ほほ 笑み、 < むっつり〉 ボタンを クリック すると ムッ とし、 
< とりやめ > ボタンの 場-合は 何も 変わらな いという ブロ グラムを 作って みましょう。 







むっブ J I 

I 



図 3-10 [口元の 形] ダイアログ ボックス 



*1 BN_CLICKED メッセージは 通知メッセージ という 〇 火 際には 「メッセージ 返送」 機 侦 によって、 ダイ 
ア ログ ボックス 以外の ウィンドウ でも 通知メッセージを 受け取る ことができ るが、？ .V •殊 な川途 に 吸ら 
れ るので、 ここでは 解説し ない。 



3 ダイアログ ボックスを 使って みよう 



まず、 ダイアログ エディタを 起動し、 3 つの プッシュ ボタンを 持つ ダイアログ ボックス 
を 作成して ください 。ダイアログ ボックスと、 それぞれの プッシュ ボタンには、 次の よう 
な キャプションと II ) をり •えます。 <0 K > ボタンと く キャンセル〉 ボタンを 流用しても か 
まいません が、 そのと きには キャプションと ID を プロパティ ボックスで 忘れずに 変史し 

てくだ さい （表 3-3)。 





キャプション 


ID 


ダイアログ ボックス 


口元の 形 


IDD.DLG.MOUTH 


プッシュ ボタン 1 


にっこり 


IDC.MOUTH-SMILE 


プッシュ ボタン 2 


むっっり 


IDC.MOUTH.UNHAPPY 


プッシュ ボタン 3 , 


とりやめ 


IDC.MOUTH.NOCHANGE 



表 3-3 [口元の 形] ダイアログ ボックスの キャプションと ID 



次に、 メニューから [衣 示]- [ ClassWizard ] を 選択す るか、 あるいは ダイアログ ボック 
ス を“ クリックして ショートカット メニューから [ ClassWizard ] を 選択して 、 ClassWizard 
を起勋 し、 ダイアログ ボックス クラスを ill 加し ます。 クラス 名は [ CMouthDlg ] とします 

(図 3-11>〇 
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図 3-1 1 [クラスの 新規 作成] ダイアログ ボックス 

次に それぞれの ボタンからの メッセージを 処理す る ハンドラを 作成し ます。 リス 卜 3-4 
に氺 すよう に、 どれ も 中 •に メッセージを 受け取ったら ダイアログ ボックスを 終 f させる だ 
けです が、 < にっこり〉、 < むっつり〉、 < とりやめ〉 の 各 ボタンの オブジェクト ID が 終 
广 ステータス として 渡される ようになって います 〇 メッセージ ハンドラ 作成 時の 指定は 例 
によって 表 3-4 に 示します。 





3.5 終了 ステータスを 知る には？ 











CMouthDlg 


IDC.MOUTH_SMILE 


BN.CLICKED 


OnMouthSmile 


CMouthDlg 


IDC.MOUTH.UNHAPPY 


BN.CLICKED 


OnMouthUnhappy 


CMouthDlg 


IDC.MOUTH.NOCHANGE 


BN.CLICKED 


OnMouthNochange 



表 3-4 各 プッシュ ボタンを クリックした ときに 実行され る メッセージ 八ン ドラ 



リス 卜 3-4 ダイアログ ボックスの メッセージ ハンドラ （MouthDIg.cpp) 

void CMouthDlg: :OnMouthSmile() 

{ 

EndDialog(IDC_MOUTH.SMILE) ; // 返り 値は IDC_MOUTH_SMILE 

> 

void CMouthDlg: : OnMouthUnhappy ( ) 

{ 

EndDialog(IDC_MOUTH.UNHAPPY) ; // 返り 値は IDC_MOUTHLUNHAPPY 

> 

void CMouthDlg: : OnMouthNochamgeO 

{ 

EndDialog(IDC_MOUTH_NOCHANGE) ; // 返り 値は IDC_MOUTH_NOCHANGE 



敁 後に [丨 丨ノ己 の 形] ダイアログを 衣 示す る 問 数、 つまり [丨 丨乂 の 形] メニューを クリックし 
たと きの メッセージ ハンドラを 作成し ます 。この ハンドラは、 上 紀 の ダイアログ ボックス 
を衣尔 し、 終 T ステータス によって 処 坪を 振り分けます （リス 卜 3-5>〇 ClassWizard で、 
表 3-5 のように 指定を して メッセージ ハンドラを 作成して ください。 



クラス 名 


CDIgTestView 


オブジェクト ID 


ID-MENU-MOUTH 


メッセ ーン 


COMMAND 


関数 名 


OnMenuMouth 



表 3-5 ダイアログを 表示す る メッセージ 八ン ドラ 



リス 卜 3-5 CDIgTestView::OnMenuMouthMBKDHg(DlgTestView.cpp) 
#include "MouthDlg.h" 

void CDlgTestView: :OnMenuMouth() 

CMouthDlg dig; 






3 ダイア □グ ボックスを 使って みよう 



switch (dig • DoModal 0 ){// ダイアログを 表示 

case IDC.MOUTH.SMILE: // DoModal 関数が IDC-MOUTH-SMILE を 返せば にっこり 



MouthPos = 10; 

InvalidateRect (NULL , FALSE) ; 
break; 

case IDC_MOUTH_UNHAPPY: 

MouthPos = -10; //DoModal(> が IDC-MOUTH_UNHAPPY を 返せば むっつり 

InvalidateRect (NULL , FALSE) ; 



break 

default 

break 

> 



// さもなければ 何もし ない 





図 3-12 実行 画面 



3.6 ダイアログ ボックスの 初期化 

MenuTest の 解説で、 メニューに チェック マークを 衣 示したり、 メニューを 無効 化する 
には、 メニューから 送られる UPDATE_COMMAND_UI メッセージを 処 邢 すれば よい こ 
とを 説明し ました 。ダイアログ ボックスの 場合 も M 様に、 丨 *丨面 衣ボの 前に 何ら かの 設定を 
行いたい ことが 多々 あります。 もちろん それを 灾现 する 方法 も丨彳 I 总 されて います。 ただし 
メニューの 初期化とは 少し ばかり 方法が 黄な り、 こちらは WMJNITDIALOG という メッ 
セージを 利用し ます。 



3.6 ダイアログ ボックスの 初期化 



WM_INITDIALOG メッセージは、 ダイアログ ボックスが 表示され る 直前に Windows 
から ダイアログ ボックスに 送られる メッセージで、 それを 処理す るのは ダイアログ ボック 
ス 自身です 。このよう にして、 ダイアログ ボックスは、 表示され る 前に 自分自身の 初期化 
を 行います。 

ここでは、 前節で 作成した ダイアログ ボックスに、 WM_INITDIALOG メッセージを 処 
理 する メッセージ ハンドラを 付け加えて みましょう 0 



クラス 名 


CMouthDlg 


オブジェクト ID 


なし （CMouthDlg を iM 択） 


メッセージ 


WM.INITDIALOG 


M 数名 


OnlnitDialog 



表 3-6 ダイアログの 初期化を 行う メッセージ ハンドラの 指定 



メッセージ ハンドラの 作成には、 やはり ClassWizard を 使用し ます 。この メッセージ 
を 受け取る のは CMouthDlg クラスです 。メッセージの 送り手は Windows システムに 決 
まってい ますから 、オブジェクト ID は 必要ありません 。メッセージの 榷 類は 当然ながら 
WM-INITDIALOG です 。という わけで、 ClassWizard で 表 3-6 に 示す 指定に そって メッ 
セージ ハンドラを 作成して ください 0 

ClassWizard が 出力す る メッセージ ハンドラの スケルトンは、 リス 卜 3-6 のように なり 
ます。 



リスト 3-6 メッセージ ハンドラの スケルトン （ MouthDIg . cpp ) 

BOOL CMouthDlg: :OnInitDialog() 

{ 

CDialog: :OnInitDialog() ; 

// TODO: この 位！ ■に 初期化の 補足 処理を 追加して ください 
return TRUE; 



ダイアログ ボックスの 標準 的な 初期化 処理は、 CDia 丨 og::OnInitDialog 間数で 行われて いる 
ので、 どんな ダイアログ ボックス も 省略す る ことは できません 0 CMouthDlg などの CDialog 
クラスの 派生 クラスの OnlnitDialog 関数は、 かならず その 先頭で CDialog: : OnInitDialog 
間数を 実行す る 必要が あります。 

また、 OnlnitDialog 丨对 数の 中で フォーカスを 移動した 場合、 返り 値と して FALSE を 返 
さなければ なりません。 ここで もし TRUE を 返す と、 ダイアログ ボックスが 実際に 表示 さ 
れる 時点で、 デフ ォルトの フォーカス 位 祺 に 戻されて しまいます。 







3 ダイアログ ボックスを 使って みよう 



ここでは CMouthDlpOnlnitDialog 関数の 動作と して、 く とりやめ〉 ボタンに フ オーカ 
スを 移動 させて みます。 コードを リス 卜 3-7 に、 実行 I 由 ilf 丨丨を 図 3-13 に 示します。 

リス 卜 3-7 CMouthDlg::OnlnitDialog 問 数の 実装 （MouthDIg.cpp) 



BOOL CMouthDlg: : 011111 itDialogO 
{ 

CDialog: :0nInitDialog() ; 

GetDlgItem(IDC-MOUTH_NOCHANGE)->SetFocus() ; // く とりやめ〉 ボタンに フォ- カス 移動 
return FALSE: 




図 3-13 実行 画面 

この メッセージ ハンドラでは、 CWnd::GetDlgItem 関数を 利 州して、 引数に 指定した ID (リ 
ソー スエ デイ タで設 走した 侦） を 持つ コントロールへの ポインタを 取 W し、 CWnd::SetFocus 
問 数で その コントロールへ フォーカスを 移して います 〇 しかし、 CWnd::GetDlgItem 間数 
を利⑴ する こので 法は Visual C + + では やや W. 色の もので あり、 使 川す るのは あまり ほめ 
られ たこと ではありません （という ことにして おいてく ださい）。 本来なら ばす ベての 処 
塊は、 MFC という: )$丄 い （？） クラス 附 W の 中で 行われるべき だからです。 そこで Visual 
C+ + には、 ある 機能が 設けられました。 …… 次 節へ 続く。 





3.7 DDX を 利用す る 



3.7 DDX を 利用す る 

ここまで 述べた ように、 ダイアログ ボックスへの アクセスは、 fi ? j 中 •ではない か、 あるい 
は Visual C + 十の コンセプトから はずれた •きたない •処理に なりが ちです 〇 DoModal _ 
数の 返り 侦 を利⑴ して ダイアログ ボックスから 情報を 得る 方法 も、 押された ボタンを 判別 
する くらいなら 役に >•/: ちます が、 文字列 データ ゃ极 数の コントロールの 設走 状況な ど、 极 
雑な データを 得る には 不十分です。 

そこで、 VisualC++ では、 DDX ( DialogDataeXchange ) という r •段を 川いて、 この 
丨⑴ 题に解 衿を 0 ••えました 〇 I)DX とは 贤 する （こ、 コントロールの 状況を 反映す る メンバ 変 
数を ダイアログ ボックスを： 及す る クラスの 中に 川ぬ: し、 その メンバ 変数を アクセス する 
ことで、 まるで ダイアログ ボックス 丨 •.の コントロールに 丨 接 アクセスして いるよう に U せ 
かけて しまう" 法です。 

DDX の 利 州 例と して、 前節で 作成した CMouthDlg::OnInitDialog 問 数を、 もっと エレ 
ガントな コードに 丨丨 Y . してみ ましょう。 







図 3-14 [メン 八 • 変数] ページに コン 卜 □一 ルが 一 K された ところ （メン 八 _ 変数 追加の 前） 

まず ClassWizard を 起動して、 〔メッセ一 ジ マップ: ページで [クラス だ から [ C . MouthDlg ] 
を 選んで ください 。そして、 [メンバ 変数] タブを クリックして ください 。あるいは、 [メンバ 
変数] タブを クリックし [メンバ 変数] ページを 衣/ してから、 [クラス ％] に [ CMomhDlg ] 
を选択 しても かまいません 。そうすると、 [メンバ 変数] ページに CMouthDlg クラスが 记 
める ダイアログ ボックスに iWi された コントロールの •なが 衣： されます （図 3-14>〇 
そこで 「 IDOIOim し NOCIIANGE 」 を 選択して 、く 変数の; £[ 加〉 ボタンを クリック 
すると、 図 3-15 のよう な [メンバ 変数の 迟 加] ダイアログ ボックスが 開きます から、 [メ 
ンバ 変数] に 適、 1 1 な 変数 名を 人力して ください。 ここでは 「丨1し1)1丨^0(：丨1抓狀」とでもして 
おき ましょう。 変数 名を 人力したら <0 K > ボタンを クリック します 3 なお、 Visual C + + 



ダイアログ ボックスを 使って みよう 



丄 I , 名 









では クラスの メンバ 変数の 名前は、- member” を总 味す る“ m_” から 始める ことを 推獎し 
ています。 




図 3-15 [メ ンノ 〔変数の 追加] ダイアログ ボックス 



変数 名を 人力し 終わったら < 0K > ボタンを クリックして、 冉び Class Wizard に 戻って 
みると、 IDC_MOUTH_NOCHANGE の 行に、 図 3-16 のよう な 設定が 書かれて います c 
これは IDC-M()UTH_NOCHANGE (く とりやめ〉 ボタン） と M 等に 扱える CButton ク ラ 
スの メンバ 変数、 m_btnNochange が 作成され たこと を, & 味し ます 0 




追加され た メンバ 変数 — T.- — — 



U 明 cajnon， ノ A1C797VZ す 



L 〇 « j 知>» 」 

図 3-16 再び ClassWizard (メン ノ落数 追加の あと） 

この m_btnNochange は、 CMoi 丨 thDlg クラスの メンバ 変数です。 ためしに ヘッダ ファ 
イル MouthDlg.h をの ぞいて みまし ょう 。リスト 3-8 のように、 CMouthDlg クラスの 史 
義の 中に、 m_btnNochange という メンバ 変数が 作られて いる ことが わかります （灰色で 
少し 見に くいです が…）。 







DDX を 利用す る 
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リス 卜 3-8 CMouthDIg の クラス 定典 （ MouthDIg . h ) 



class CMouthDlg : public CDialog 

{ 

// コンスト ラ クシ ヨン 
public : 

CMouthDlg (CWnd* pParent = NULL); // 標準の コンストラクタ 
// ダイアログ データ 

//{{AFX.DATA (CMouthDlg) 
enum { IDD = IDD_DLG.MOUTH }; 

CButton m_btnNochcinge ; // •- これ だ！！ 

//»AFX_DATA 



これ 以降、 m _ btnNodiange への アクセスは 、く とりやめ〉 ボタンの アクセスと 同じぬ: 
味を 持ちます 。そこで、 mJtnNochange を 使って CMouthDlg :: OnInitDialog 関数を it き 
め: せ ば、 リス 卜 3-9 のようになります 0 

リスト 3-9 変更した CMouthDlg :: OnlnitDialog 間数 （ MouthDIg . cpp ) 



BOOL CMouthDlg: :OnInitDialog() 

{ 

CDialog: :OnInitDialog() ; 

m_btnNochange.SetFocus() ; // く とりやめ〉 ボタンに フォ一 カスを 移動 
return FALSE; 








実行 画面 
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3 ダイアログ ボックスを 使って みよう 



ここで 注意して おきたい のは、 m_bt nNochange は ボタンの 状態を 反映す る 変数に すぎ 
ず、 ボタン そのもの ではない という ことです 。あくまでも、 DDX の 機能が 働いて 「コン 卜 
ロールを 仮想 的に 表す 変数」 と 「コントロール そのもの」 の 問で、 H 勋 的に データを 交換し 
て くれてい るた め、 丨 时 行が 同 等に みなせる のです。 

この データ交換が 行われる しくみと、 実際に データが 交換され る タイミングに ついては、 
次 節で 説明し ましょう 0 

3.8 値 型の DDX 

前節で 説明した のは、 ダイアログ ボックス 上の ボタンを 、ボタンを 衣す CButton クラス 
の 変数を 介して アクセス する DI)X でした 。中 •純 明快では あります が、 CButton クラスの 
動作を 知らなければ 使えない のが 難办 かもしれ ません。 このように、 コントロールを それ 
と 同じ クラスの 変数で 衣す DDX を コン 卜 ロール 型の DDX と 呼びます: 

そしてもう 1 つ、 値 型の DDX と 呼ばれる ものが あります。 これを 使う と、 コント ロー 
ルの 状態が 幣数 や文卞 列な どの 形式で 衣され るた め、 より 扱い やすい ものになります。 
ただし、 コントロールの 神: 類に よって、 利⑴ できる データ 形式は 決まって います。 

侦咽の DDX の 利; II 例と して、 図 3-1 8 のよう な ダイアログ ボックスを 噃備 しましょう。 
この ダイアログ ボックスは メ丨 •ソ丨 •の 丨丨丨 ミの 叫きを 変える ものです 。コン 卜 ロールの 迫い によ 
り データの 神 類が 変わる ことを 兑て もらうた め、 心 •丨丨 の 制御に チェック ボックスん 丨丨に 
は ラジ 才 ボタンと いう 铒 なる コントロールを 使) 丨丨 してみ ました。 




左目の 向？^ — 

r 2E@|J6«SK 

广 左目 



〇 K | 私:/^ i 



図 3-18 [目の 向き] ダイアログ ボックス 



3.8 値 型の DDX 





3 ダイア □グ ボックスを 使って みよう 

その ドに 2 っの ラジ 才ボ タンを 配 的し ます。 ラジ 才 ボタン もやは り [スタイル] ページの 
[囪 動] はかならず チェックされ たま まにして おいてく ださい。 ラジオ ボタンの ID の 値は、 
1 っの グループの 屮で迚 続 させて おくと 後々 の 扱いが 楽になります。 灾際 には ラジ オボ 夕 
ンを 連続して 配 骰 すれば、 ダイアログ エディ 夕が 割り a てる id に 割り 沒 てる 値 （ id 値） も 
迚続 します が、 確実に 速 絞させる ために、 ここでは 「 id 名 = id 侦」 という 形式で、 id 名 
と 時に ID 侦 も人ノ J します 0 この II ) 侦は 、リソース エディ 夕が 他の コントロールに 肉勋 
的に 割り 肖て る侦 （100 から 始まって 1 ずつ 坳 える） と 衝突し ないように、 少し 人き めの 倘 
として 300 および 301 を 選びます （図 3-21、 図 3-22>。 




図 3-21 [左目は 右を 向く] ラジオ ポタン （IDC RAD 1) の プロパティ 




図 3-22 [左目は 左を 向く] ラジオ ボタン （IDC RAD 2) の プロパティ 



3.8 値 型の DDX 
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M 後に ラジオ ボタンを W むた めの グルーブ ボックスを 配 敗し ます 。グループ ボックスは 
必須ではありません が、 Windows の惯沔 には 素直に 従った 方が いいで しよう。 なお グルー 
プ ボックスは メッセージを いっさい 発生し ません 。このような メッセージを 発生し ない コ 
ン トロールには、 「 IDC _ STATIC 」 という 特別な ID が 与えられます （図 3-23) 0 




図 3-23 グループ ボックス 「左目の 向き J の ブロ パティ 



また、 タブ オーダーの 設记 にも シ (を W る必费 があります。 匚 CtriJ + 闽 を 押す と （あるい 
は [レイアウト]- [タブ オーダー] コマンドを 灾行 すると）、 各 コントロールの 脇に 現在 •の 
夕ブ オーダーが 数字で 示されます 〇 故 ベめ: したい 顧に コントロールを クリックして くださ 
い。 iii •初に クリックした コントロールの タブ オーダーが 1、 次に クリックした ものが 2、 と 
変わって いきます。 iti 終 的に 図 3-24 のように 設定し、 押び + 回を 押せば、 そこで 
夕ブ オーダーの 変史は 完了し ます。 




図 3-24 タブ オーダーの 投定 



さりに タフ 才ー ダーの 順で ク ループの 先頭に あたる ラジオ ボタンと、 グルーブの 最後の 
ラジ 才 ボタンの 1 つ 先の コン 卜 ロールは、 ブロ パ テイ ボックスの： グループ] を チェックし 
なければ なりません ； 今 、作成して いる ダイアログ ボックスでは 、ラジオ ボタンの タブ オー 
ダーは 2 から 3 までな ので、 図 3-25 のように タブ オーダーが 2 の ラジオ ボタンと、 4 のグ 
ループ ボックスに ついて： グループ] チェック ボックスを チェック する わけです。 




図 3-25 先頭の ラジオ ボタンと « 後の 1 つ 先の コン 卜 □一 ルの プロパティ 



以丨 •.で ダイアログ ボックスの 作成が 終わりました 。クラスを 众鉍 する ため、 C 丨 ass Wi zar d 
を 起则 し、： クラスの 新说 作成： ダイアログ ボックスで [クラス 名] に [ CEyeDlg ] を 指 沿し 
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0 3-26 [クラスの 新規 作成] ダイアログ ボックスで [ CEyeDlq ] という クラス 名を 指 足 



さて、 ここから が DDX のた めの 焱定 です， ClassWiza 丨 xl の [メンバ 変数] タブを ク リッ 
ク してく ださい 〇 ClassWizard に [メンバ 変数] ページが 衣ボ され、 ダイアログ ボックスに 
fld 敗した コントロール •览 が衣ボ されます （図 3-27 > c 




ht^/TiV ぬ ATM | ト ン | へ ： 4 | ” ス 1M8 | 

W/i«D<L) -I 




図 3-27 [メ ンノ (変数] ページ 



ー览 リストに 衣 示される のは、 接 本 的には DDX を 利 川"]* 能な すべての コントロールで 
す。 ただし グループに まとめられ ている ラジ 才 ボタン に関しては、 グルーブの 光頒の （タ 
ブ オーダーが ー济 小さい） ラジオ ボタン だけが 衣 示されます。 

それでは まず、 [心 • II がイ I •を A く] チヱ ック ボックスに 対丨え; する メンバ 変数を 沿 加し ま 
しょう 〇 IDC _ CHK_RR を 選択し、 く 変数の 边加> ボタンを クリックして ください 。そし 
て、 [メンバ 変数の; n 加] ダイアログ ボックスで [メンバ 変数] に 変数 名を 指) ii します。 こ 
こでは [ m _ chkRR ] として おき ましょう （図 3-28>。 





図 3-28 [メン ノ该 致] ページ （ m _ chkRR を 追加） 

このと き [カテゴリ] ボックスに [侦] と 衣 示されて いる ことに 注盘 してく ださい。 これ 
が侦 型の DDX である ことを/』 i します。 なお [カテゴリ] に [コン 卜 ロール] を 選択 すれば、 
コン 卜 ロール 沏の DDX 変数 も 作成で きます 0 

また [変数の 夕 イブ] が [ BOOL ] と 衣/ ji されて いる ことから わかる ように、 この 変数は 
チェック ボックスの チェックの イ丨 •無に 応じて、 TRUE または FALSE という 侦を 取ります 0 
一般に チヱ ツク ボックス に対する 侦 型の DDX 変数は BOOL 彻 になります 0 

続いて ラジ 才 ボタンの 状態を 調べる メンバ 変数 も定 在し ます。 [メンバ 変数] ページで 
IDC _ RAD _1 を 選択し、 < 変数の 追加 > ボタンを クリックして ください。 メンバ 変数 名は、 

「 m jradlndex J と 指定し ます （ 面 3-29) 0 




図 3-29 [ メ ンノ CS 数 ] ページ （ m_radlndex を iBJQ) 



3.8 値 型の DDX 



ラジオ ボタンに 対する 値塑の DDX 変数は、 先頭の ラジオ ボタンが 選択され ている 場合 
に 0、 その 次なら ば 1 …… 、という 速 絞した 整数 値を 取ります。 

変数の 追加が 終 r したら、 <〇 K > ボタンを クリックして、 ClassWizard を 終了し ます。 
次に、 これらの DDX を 突 際に プログラムの 中で 利) II してみ ましよう。 まず、 ダイアログ 
ボックスを [ 丨丨 の 叫き] メニューで 表示す る ことにします 。表 3-7 のよう な 設定で メニュー 
の メッセージ ハンドラを 作成して ください。 



クラス 名 
オブジェクト ID 


CDIgTestView 

ID.MENU.EYE 


メッセージ 1 


COMMAND 


関数 名 


OnMenuEye 



表 3-7 DDX を 利用した ダイアログ ボックスを 表示す る メッセージ 八ン ドラの 指 足 
川ノ J された スケルトンを リス 卜 3-10 のよう な プログラムに 変 1 上します。 



リスト 3-10 CDIgTestView::OnMenuEye 関数 （ DlgTestView.cpp) 



#include "EyeDlg.h" 

void CDlgTestView: :0nMenuEye() 

{ 

CEyeDlg dig; 

dlg.m.chkRR = (RtEyePos < 0 ? TRUE : FALSE); "m_chkRR の拉定 
dlg.m.radlndex = (LtEyePos < 0 ? 0 : 1); // m_ rad Index の拉定 

if (dlg.DoModalO == IDOK) { 

RtEyePos = (dlg.m_chkRR ? -10 : 10); 

LtEyePos = (dlg.m.radlndex == 0 ? -10 : 10); 

InvalidateRect (NULL, FALSE); 

} 



この プログラム ではまず CEyeDlg クラスの オブジェクト dig を 作り、 続いて dlg.nuchk 
RR および dlg.m_radlndex という 2 つの DDX 変数が 現在の 顔の 表悄を 反映す るよう に設 
定 します。 dlg.m_chkRR は、 右目が 右を 向いて いる （RtEyePosCO ) ときは TRUE、 右目 
が 左を 向いて いれば FALSE です。 dlg.m_radlndex は ラジ 才ボ 夕ンの 順番です から、 左目 
が 右を 向いて いる （LtEyePosCO) ならば 0 を、 左目が 左を 向いて いれば 1 に 設定し ます。 

ここで DoModal 間数を 実行す ると、 その 中で CDialog::OnInitDialog 関数が 呼び出され、 
さらに その 中から CWndnUpdateData 関数が 呼び出されます 〇 UpdateData 関数は ダイア 
ログ ボックス クラスの オブジェクトと ダイアログ ボックスの 問で データ交換を 行う もので、 
次のように FALSE を 引数と すると ダイアログ ボックスへ データを 転送し、 TRUE を 指定 




似一 3 ダィァログ ポッ クスを 使っ てみ ょぅ 




図 3-30 実行 画面 



すると ダイアログ ボックスから データを 説み 取ります。 

CMyDialog dig; 

dig. UpdateData (FALSE) ; "dig から— ダイアログ ボックスへ 転送 

dig. UpdateData (TRUE) ; " dig へ-ダイアログ ボックスから 転送 

すでに 述べた とおり、 CDialog::OnInitDialogW) 数は ダイアログ ボックスが 肉 •曲に 衣 示さ 
れる跑 前に 呼び出される 閲 数です 0 この閲 数の 中では 引数を FALSE として UpdateData 
間数を 灾 行して います。 そのため 丨由 lift 丨上に 衣 示される ダイアログ ボックスには 常に ddx 
変数の データが 反映され るので す。 

<0K> ボタンを クリック すると CDialog::OnOK 閲 数が デフォルトでは 呼び出されます 
か、 v •の丨 S4J 数の 屮で はリ丨 数を 丁 R じ {{としてし -pdateDatalW 数が 災行 されます 。そのため 
<0K> ボタンを 押して ダイアログ ボックスを 丨約 じる と、 ダイアログ ボックスの デ 一夕が 
I)DX 変数に 代入され るので す。 よって、 DoModal 問 数が 終 T した 時点で DI)X 変数の 侦 
を 調べれば、 ダイアログ ボックス に対して 行った 操作が 説み 取れる わけです。 



3.9 DDV で 入力 データを チェック 

チェック ボックス に対する 値 型 •の DDX 変数は、 かならず FALSE か TRUE の 値を 取り 
ます。 ラジ 才 ボタン でも DDX 変数の 侦は 一定の 範 I 用の 整数と なること が 決まって い ます。 
したがつ て、 これらの コントロールに ついては、 DDX 変数の 倘の 有効性を 調べる 必要は 



3.9 DDV で 入力 データを チェック 



173 



ありません 。しかし 任： e ; の 文字列が 入力 可能な エディット ボックスを 扱う 場合は、 人力 
データが 治 •効な もの かどう かを 調べる 作業が 不可欠です 。この 頊 では DDV (Dialog Data 
Validation) という 機能を 利 叩して、 エディット ボックスに 入力した デ 一夕の 有効性を チ エッ 
ク する ノア 法を 説明し ましよう。 

まず エディット ボックスの 利⑴例 として、 図 3-31 のよう な ダイアログ ボックスを 作成し 
ます。 この ダイアログ ボックスは、 W 毛の f 、>: 沢と 太 さを、 それぞれ エディット ボックスを 利 
川して 人力し ようとい う ものです 0 




図 3-31 [眉毛の 投定] ダイアログ ボックス 

まず リソース エディタで ダイアログ ボックスを 新規 作成し、 <〇 K > ボタンと <キ ヤン セ 
ル〉 ボタンを 図 3-32 の f 、>: 阶に 移します 。ダイアログ ボックスの キヤ ブシ ヨンは [ W 毛の 設 
定 ]、 ID は [ IDD - DLG - BROW ] とします。 




[屬 毛の 投定】 ダイアログ 
ボ て 



図 3-32 [眉毛の 投定] ダイアログ ボックス （ IDD - DLG - BROW ) の ブロ パ テイ 



3 q nnv で 入力 データを チェック 




エディット ボックスの 外兑は 準なる 叫 角 形で、 これ 0 体には キャプション も 何も 付き ま 
せんので、 各 エディット ボックスの 左側に ラベルを fliiiS して、 エディット ボックスの 説明を 

記述す る ことにします （図 3-35、 図 3-36> 0 



ラベルと その ブロ パ テイ 



図 3-35 [位 画] ラベルと その ブロ パ テイ 





図 3-36 [太 さ] ラベルと その ブロ パ テイ 



このように エデ イット ボックスに ラベルを 付けた 場 •介は、 図 3 _ 37 に 示す ように、 対 化す 
る ラベルと エディツ 卜 ボックスが 迚絞 する ように タブ オーダーを •脚 被し ます。 こうして お 
くと、 ラベルに 指定した アクセス キーで エディット ボックスに フォーカスが 移動して くれ 
ます。 たとえば この 例では、 匚 AI[ + [P ] を 押す と 旳人ノ j 川の エディット ボックスが 選択 
され、… AU +W を 押す と 人 さ 人力 川の エディット ボックスが 選択され ます。 




図 3-37 この ダイアログ ボックスの タブ オーダー 



以丨 ••の 作 袋が 終广 したら、 ClassWizard を 起！ Wj して、 この ダイアログ ボックスの クラス 
を プロジェクトに 逍 加し ます。 クラスれ には [CB r0W D は] を 指定して ください （囡 3-38) 。 




凶 3-38 [クラスの 新規 作成] ダイアログ ボックスで [ CBrowDIg ] という クラス 名を 指定 

次に エディッ 卜 ボックス 川の m)x 変数を 川 立し ます） [メンバ 変数] タブを クリックし 
て、 [メンバ 変数] ページを 衣ボ してく ださい。 

外 エディッ 卜 ボックスの 丨人 を 炎す 侦喂の DL)X 変数と して、 ここでは 図 3 - 39 に 示す よ 
うに、 「m_nBrowPosm 毛の 位 沢）」 と 「 m _nBrowWidth(Vi 毛の 人 さ）」 を 作成し ます。 
エディッ ト ボックス 川の 侦咽の DDX 変数には、 CString、 int、 float など、 いろいろな デー 
夕 咽を 選ぶ ことができ ますが、 m _ n BrowPos (- 20 から 20 までの 整数 侦 U こは int 彻を選 
びます 〇 m_nBrowWidth(l から 15 までの 整数 値） には UINTM を 使って みましょう。 
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図 3-39 [メン ハ 艾 数] ページで メンノ 落 致を 作成 

エディット ボックスに 対する 倘彻の DDX 変数を 作成す ると、 [メンバ 変数の 褊染] ダイア 
ログ ボックスの ド邡 で、 データの イ丨効 萜丨 用の 指定が できる ようになります。 int 喂や UINT 
吧 などの 数侦 形式の DDX 変数では、 図 3-40 のように [iti 少侦] と [最大値] が 指 走 4 能で 
す 。なお、 今 M は 使いませんで したが、 CStringM の DDX 変数の 場合は 「鉍 人文字 数」 を 
指记 できます， 

ここでは それぞれの I)I)X 変数に、 表 3-8 のよう な伋 少侦と W 人 侦を指 走して ください 

(図 3-41)。 



ダイアログ ボックスを 使って みよ 




追加した メンバ 



口 



偏坠の DDX 变 数では 
有効 範囲を 指定で きる 



[ 0K ] 



3-40 DDX 変数の 有効 範囲の 指定 ボックスが 現れた ところ 
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以丨 •.で [1丨'1 での 設定] ダイアログ ボックス に関する 設定が 終わりました。 この ダイアログ 
ボックスは [ VI 毛] メニューで 衣 示す る ことにします。 表 3-9 のよう な 設定で メニューの 
メッセージ ハンドラを 作成して ください。 

出 ノ J された スケルトンは リス 卜 3 - 11 に/ 丨 •くす ように 修丨丨 •: してく ださい 〇 m _ nBrowPos は 
int 咽、 m _ nBrowWidth は UINT ® の DDX 変数と して 定義し ましたから、 BrowPos や 
BrowWidth などの 幣数侦 がめ: 接 代人で きます。 



クラス 名 


CDIgTestView 


オブジェクト ID 


iD . MENU.BROW 


メッセ ーン 


COMMAND 


関数 名 


OnMenuBrow 



表 3-9 [眉毛] ダイアログ ボックスを 表示す る メッセージ 八ン ドラ 



リス 卜 3-1 1 CDIgtestView :: OnMenuBrow 間数 （ DLGTEVW . CPP ) 
#include "BrowDlg.h" 

void CDlgTestView: :OnMenuBrow() 

{ 

CBrowDlg dig; 

dlg.m.nBrowPos = BrowPos; 
dlg.m.nBrowWidth = BrowWidth; 
if (dlg.DoModalO == IDOK) { 

BrowPos = dlg.m.nBrowPos; 

BrowWidth = dlg.m.nBrowWidth; 

InvalidateRect (NULL, FALSE) ; 




それでは ブロ グラムを コンパイル/ 灾 行して みまし ょう （図 3_42>〇 [ VI 毛] メニューを 
クリック すると [丨丨 ' I 毛の 設定] ダイアログ ボックスが 開きます 。まず VI での 位砰の エディッ 
ト ボックスに 適、 丨 1 な データを 人力して ください 。次に [ Tab か [Alt +W を 押して フ才ー 
カスを 移# させ、 丨丨 ' I での 人 さの エディット ボックスに データを 人力し ます 。ここで <〇 K > 
ボタンを クリック すると （ L ^? L を 押しても よい）、 ダイアログ ボックスが 閉じ、 丨 毛の 位 
抓と 太 さが 変わります。 

ダイアログ ボックスが 期 作 どおりに 動作す る ことを 確かめたら、 今度は わざと イ f 効範 間 
外の データを 人力して みましょう 。たとえば 丨丨 ' It の 位 的を [100] として <〇 K > ボタンを 押 
してく ださい 。すると 図 3-43 のよう な メッセージ ボックスが 衣 / J •くされ、 正しい データを 
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3 ダイア □グ ボックスを 使って みよう 




図 3-42 実行 画面 



再 入力す るよう に 促されます。 自動的に データの 妨効 範丨用 チヱ ックが 行われた のです。 こ 
の データ チェック 機構が DDV です。 





図 3-43 入力 データが 不正で あつた ことを 示す メッセ一 ジ ボックス 



ここまで 述べて きたよう に、 エデ イット ボックスで データ 人力を 行う ダイアログ ボックス 
を 作成す ると、 ごく 巧然 のように DDV の 機能が 糾み 込まれ、 プログラム 中で データ チヱ ッ 
クを 行う 必要が ほとんどなくなります。 



マウスと キ 一 ポ 一 ド 
4 からの 入力 



メニュー や ダイアログ ボックスを 操作す る 場 •介には、 「メニューが 選択され た」 あるいは 
「コントロールの 状態が 変 された」 というよ うな、 ある 秤 度の 味を 持った メッセージが 
得られます 。これは マウス ボタンを 押したり キーボードから 文 7 を 人力す る ことで ; 丨: •じた 
メッセージを Windows が処 邢 して くれてい る おかげです。 しかしこう いった 特別な 処 H 
の 恩 也が 受けられない 部分、 つまり クライアント 箾 域の 丨 ••では、 ブロ グラマが HA/ で 小の 
マウス や キーボードからの メッセージを 処现 する 必要が あります 。この 0 では、 マウス メッ 
セージを 処 PI! して マウス 人ノ J を 行う" 法と、 キーボード メッセージを 処洲 して キーボード 
人力を 行う 方法を 説明し ます。 

4.1 マウス 入力 

從來の MS-DOS プログラミングでは、 マウスからの 人力 データは、 プログラム 側が 「マ 
ウスの 状態を 凋べ る BIOS」 を灾 行して 説み 取る ことに なって いました 0 

しかし Windows では、 すべての 人出 力 操作は メッセージを 介して 行われます。 マウス 人 
力に 閲 しても 例外ではありません 。ユーザーが マウスを 操作す ると 各 神の マウス メッセ 一 
ジが 発生し、 アプリケーションは その メッセージを 受け取って しかるべき 処理を 進める の 
です。 Windows プログラミングとは、 こちらから システムを 呼び出す のでは なく、 あくま 
でも 送られて くる メッセージを 待つ もの だとい う 受け身の fiX 則は ここで も 健 fr: です。 

節では マウス メッセージの 扱い 力を 学ぶ ため、 図 4-1 のよう な Toothpaste (練り 附 
奶 き） グラフィックスを 描く お 絵 かき プログラムを 作って みます。 なお 付録 CD-ROM の 
Paste ディレクトリには、 この プログラムの 完成 版 （次 節で 述べる キーボード 人力 機能を 追 
加した もの） が 収めて あります。 
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図 4- 1 Toothpaste グラフィックス 



籲 スケルトンの 作成 

まずは AppWizard で プロジェクトの 丨.台 となる スケルトンを 作成し ます。 この ブ ロジェ 
クト には 以 ドの 設定を ひえます。 

•プロジェクト 名： l) aste 
♦アプリケーション タイプ： SI)I 
春 データベースの サボー 卜： しない 
參极介 ドキュメントの サポート： しない 
♦ツール バー ステータス バー： なし 
♦印刷と 印刷 プレビュー： なし 
♦そのほか： デフ ォルトの まま 

この 灸 fl - に從 つて、 AppWizard の 才ブシ ョンを 設记 してく ださい 。スケルトンが 作られ 
たら、 リソース エデ ィタを 使 川して、 以ド のように メニューの イく 要項 丨| を 削除し ます。 メ 
ニ ューの 修丨丨 :ノゾ 法に ついては 、前 出の MenuTest プロジェクトを 参 名に してく ださい。 図 
4-2 にこの プロジェクトの メニュー 丨丨丨 ij 丨 f 丨丨 •を 示します。 

•[フ ァイ ル] メニューは [アブリ ケー シ ョンの 終了] だけ 残して それ 以外を 削除す る 
• [褊 犯] メニュー 以 ドの メニューは すべて 削除す る 

Pwt e の ハし シオ,: I 




図 4-2 Paste ブ ロジェ ク 卜の メニュー 
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春 リソースの 準備 

次に Toothpaste グラフィックスを 描く ための 矜 十の 準備を 行います。 Toothpaste グラ 
フィックスは、 丨由 i 丨 fu •だけ U ると ウネ ウネの グ ニヤ グ ニヤで、 どのように 描かれて いるの か 
わかりに くいので すが、 描 闽 の 取理は 非常に 簡单 です 0 
用意す る ものは 図 4-3 に 示す ような! M い 丸と い モヤ モヤの 2 つのは 丨形 です。 患 丸を マ 
ウスの 移 勅に つれて 即唑に 衣り i し、 その あとで 少し 迦れて 「 I モヤを 取ね ていく と、 あの ウ 
ネ ウネが 現れる という 仏 •掛けです。 




図 4-3 Toothpaste グラフィックスの もとになる 2 つの ビットマップ 



2 つの 丨*ズ丨 形 データは ビットマップ リソース として 川 尨し ます。 ビットマップ リソースの 
作成には、 リソース エディ 夕に 穴 まれて いる グラフィック エディ 夕を 利) | j します。 

まずは、 メニューから [挿 人]- [リソース] を迸択 する か、 ワーク スペース ウィンドウ 
の [ KesourceView ] ページで [ Paste ] フォルダ をむ クリックして シヨ一卜 カット メニュー 
から [神人] を 選択し、 [リソースの 袖 •人] ダイアログ ボックスを 衣/ します 0 次に、 [リ 
ソースの 挿 人] ダイアログ ボックスから [ Bit map ] を迸択 し、 く 新規 作成 > ボタンを クリッ 
ク します 。すると グラフィック エディタが 起# して、 丨' 丨い 丨丨: 力 •形の ビットマップが 衣尔 され 
ます。 この £方 形の 枠線の イ I •ドを マウスで ドラッグして 横 64 ドット x 縦 32 ドットの サイ 
ズに 変更し、 さらに 格 丨 1 】 塗りつぶし ッールな どを 利 川して 上記の 図 4-3 にボ すよう な 図形 
(左 半分は 白地に 黒丸、 右 半分は 黒地に!! 丨い 点） を 描いて ください。 

iti 後に ビットマップの 外側の 部分を マウスで ダブル クリック すると、 ビットマップの プ 
ロ パ ティが 表示され ます。 ここでは [ ID ] ボックスに [ IDB _ PASTE ] と 人力し ます。 これ 
で リソースの 準備は 完了です。 

♦ウネ ウネを 描く 関数 

次に 出 丸と D モヤを 時 問 恙衣 示す るた めの サポート； II の 問 数を 2 つ、 PasteView . cpp ファ 
イ ルの/ ti 後に 追加し ます （リスト 4-1>〇 これらの 丨知 数は、 あとで 作成す る マウス メッセ 一 
ジ ハンドラの 中から 呼び出されます。 
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リス 卜 4-1 GrowLine 関数と ShrinkLine 関数 （ PasteView.cpp) 

CObList PointList; 

void GrowLine (CDC* pDC, CPoint point) 

CBitmap Bitmap, *p01dBitmap; 

CDC MemDC; 

//point で 示される 座棵に 黒丸の ビットマップを 表示す る 
Bitmap. LoadBitmap(IDB. PASTE) ; 

MemDC.CreateCompatibleDC(pDC) ; 
pOldBitmap = MemDC.SelectObject (ftBitmap) ; 

pDC->BitBlt (point. x - 16, point. y - 16, 32, 32, &MemDC, 0, 0, SRCAND) ; 
MemDC.SelectObject (pOldBitmap) ; 

// PointList の 先頭に point を 追加す る 

PointList . AddHead((CObject*) (new CPoint (point) ) ) ; 



void ShrinkLine (CDC* pDC) 

{ 

CPoint* pTail; 

CBitmap Bitmap, *p01dBitmap; 

CDC MemDC; 

//PointList の 末尾から 座摞を 取り出して 白 モヤを 表示す る 
pTail = (CPoint*) PointList .RemoveTailO ; 

Bitmap • LoadBitmap(IDB-PASTE) ; 

MemDC.CreateCompatibleDC(pDC) ; 
pOldBitmap = MemDC.SelectObject (^Bitmap) ; 

pDO>BitBlt(pTail->x - 16 ， pTail->y - 16, 32, 32, &MemDC, 32, 0, SRCPAINT); 
MemDC.SelectObject (pOldBitmap) ; 
delete pTail; 



この 2 つの 閲 数は、 水 節の II 的で ある マウス 処理とは あまり 閲係 がありません。 ここで 
は ざっと 励 作を 説明す る だけに とどめて おきましょう。 

Jii •初の GrowLine 閲 数は、 引数 point で 指定した 座標に 黑 丸の ビットマップを 衣ボ し、 さ 
らに その 崦標を あとでもう •度 参照で きる ように、 PoimList という データ バッファの 光頒 
に 追加し ます。 なおこの 関数では ビットマップ 表ボを 行う 際に CDC::BitBlt 閲 数の 第 8 引 
数と して SRCAND 才ぺ レー シ ヨンを 指记 している ため、 ビットマップの 丨4 色の 部分は 竹 
设が そのまま 変！ If されずに 残り、 黑色 部分 だけが 幽 側 に 書き込まれます。 

2 つ t 丨の ShrinkLine 関数は、 保存して おいた 嵴標を PointList から 取り出して、 そこに 
に I モヤの ビットマップを 衣ボ します。 こちらは CDC::BitBlt 関数で SRCPAINT オペ レー 
シ ヨンを 指 走して いるた め、 ビットマップの 黑色 部分は 背 设の まま 変わらず、 部分 だ 
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けが 両面に 表示され ます。 したがって、 たとえば GrowLine 閲 数を 10 回 呼び出して 黒丸を 
表示して おき、 続けて ShrinkLine 関数を 10 冋 呼び出せば、 10 個の 黒丸の 上に 順次 白 モヤ 
が 表示され ていく わけです。 

リス 卜 4-1 では Poi 丨 uList に キュー* 1 の 役割を 持たせて いますが、 これを 灾 现 する ため 
に、 バッファの 先頭と 未甩 から 0丨|丨 に データの 追加 や 削除が できる CObList クラスを 利 IH 
しました 〇 CObList クラスの 機能 や 使い" に 問して は、 オンラインマニュアルの 「MFC リ 
ファ レンス」 を 参照して ください 0 

また GrowLine WI 数屮の 「new CPoint (point) J は、 point と 等しい 内科を 持つ CPoint 

クラスの 新しい オブジェクトを 作成し ます。 作成され た オブジェクトは あとで ShrinkLine 

関数 中の 「delete pTailJ によって 削除され ます。 new 演 t): 了 •と delete 演兑 r* は、 C 言語の 
malloc 閲数 による メモリ 確保と free 丨划 数に よる メモリ 解 攸の作 策を 「丨 動 イ 匕した ような 機 
能を 持ちます。 



春 マウス メッセージ 

まず マウスから 送られる メッセージの ff (頌と 、その 使い" を肫丨 に •说 明し ます。 

もっとも 中 •純な マウス メッセージは、 クライアント 領域で ボタンが 押された 臟 -IIU にノ 1:. じ 
る ボタンダウン メッセージと、 離された 瞬 問に 中 じる ボタン アップ メッセージです。 これ 
らの メッセージは マウスの ノ r:“ の ボタン ごとに 川 尨され、 それぞれ 次の ような 名前が ひえ 
られ ています。 

• WM_LBUTTONDOWN : ノ r: ボタンが 押された 

♦ WIVLLBUTTONUP : ノ I: ボタンが 離: された 

• WM_RBUTTONDOWN : 心 •ボタンが 押された 

♦ WM_RBUTTONUP •• 心 •ボタン 力 《離された 

また クライアント 領域で マウス カーソルが 柊# すると、 次に 示す マウス 移動 メッセージが 
発 z|: •します。 システムの 処观 速度に よっても 興なります が、 これは マウスの 軌跡を あまり 細 
かく 衣す ものではありません。 マウスを ぶ丨丨 丨. く柊勋 させた 場合な ど、 WM_MOUSEMOVE 
メッセージの 平 •じる 問隔 は、 かなり 飛び飛びになります。 



• WM_MOUSEMOVE : マウスが 移勋 した 



マウス ボタンを クリック する ことは、 Windows の ユーザー インターフェイスの 媒 本です 
が、 クリック （押して 離す） という# 作 そのものを 衣す マウス メッセージはありません 。こ 
れは ボタンダウンと ボタン アップの 紐み 介 わせで 简丨 ji. に 判 泡で きる からです。 しかし ダブ 



*1 キュー （Queue: 光 人れ; t 出し バッファ > 〇 たとえば A、 B、 C という データを この Wiffi ■•で •丨 :: き 込む と、 
1“1 じく A、 B、 C という 順 ifr で 取り出す ことができる。 プログラムの ように、 •迚の データを 丨丨 
系を 的 いて 説み # きしたい 場 •介に よく 利 川され る 
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ル クリックには、 その© J 作を 衣す リ/ 川の メッセージが 存存: します。 左右の 各 マウス ボタン 
に、 以 ドの 名前の メッセージが 対応し ます 0 

• WM_LBUTTONDBLCLK : ノ r: ボ夕ン が ダブル クリック された 

♦ WIVLRBUTTONDBLCLK: イ丨ボ タンが ダブル クリック された 

ダブル クリック メッセージは、 •走 時 問 内に 一 走 範网の 四角形の 中で、 マウス ボタンが 
続けて 2 | m | クリックされ た坳 介に 十 •じます。 以 初の クリックの 時办 では、 それが ダ ブルク 
リックの 1 | n 丨丨丨 なのか 中 •なる クリック なのか 判断で きないた め、 通常の ボタンダウンと ボ 
夕ン アップ メッセージが 送り出されます。 そして ダブル クリックの 2 M|| の クリックの 際 
に、 ボタンダウン メッセージの 代わりに ダブル クリック メッセージが 発 屯し ます。 つまり 
ダブル クリックの 際には、 次の 4 つの メッセージが) ((((こ 送られて いる わけです （& ボタン 
の坳介 ）〇 

1 • ボタンを 押す： WM_LBUTTONDOWN 

2. ボタンを 離す： WM_LBUTTONUI) 

3. ボタンを 押す： WM_LBUTTONI)BLCLK (これが ダブル クリックを 示す） 

4. ボタンを 離す： \VM_LBUTTONUP 

ボタンダウン、 ボタン アップ、 マウス 移#、 ダブル クリックの 各 メッセージが 送られる 
除には、 かならず 2M 類の 悄 報が 付加され ます 〇 1 つは マウス カーソルの 位骰 、そしても 
う 1 つは 押されて いる マウス ボタンと シフトキーの 状態を ポす怙 報です 〇 ClassWizard で 
作成した マウス メッセージの メッセージ ハンドラには、 この 2 つの データが 次の ような 引 
数と して 渡されます。 

void CPasteView: :OnLButtonDown(UINT nFlags, CPoint point) 

{ 

// WM_LBUTTONDOWN の 処理 

> 

第 1 リ丨 数の nFlags は、 表 4-1 に/ す ビット フラグの 論 利 和と なって います。 MK 胃 MBUT 
TON フラグは 3 ボタン マウスの ために 川 立 された もので、 M 常の 2 ボタン マウスでは 常 
に 0 となります。 また MK_SHIFT フラグ や MK_CONTROL フラグは キーボードの 状態 
を づ ミし ますが、 これが マウス メッセージに 禽 まれて いるのは、 Windows アプリケーション 
では jhift 」 や Ctrl を 押しながら マウス 操作を 行う ことが 多い という、 ごく 窠際 的な 理山 
からです。 プログラミングの: T •問を 竹く （いちいち キーボードの 状態を 調べな く ともよい〉 
ための、 ちょっとした 心 rti! りでは あります 
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フラグ 1 


意味 


MK.LBUTTON 


左 ボタンが 押されて いる 


MK.RBUTTON 


右 ボタン ゥ 


MK.MBUTTON 


中 ボタン 々 


MK.SHIFT 


| Shift | ❖ 


MK.CONTROL 


Ctr 丨 ]* 



表 4-1 nFlags の* 味 



マウス メッセージの 第 2 リ丨数 point は、 メッセージが 発 7 k した 麟 :丨⑴ の マウス 力一ソルの 
位趵 をボす CPoint クラスの データです。 クライアント 領域の ノ r: 丨 ••隅が 职点 （(X 0> となり 
ます。 CPoint クラスの データは x 喵標と y 崦 掠を 小す 2 つの メンバ 変数で 構成され、 これ 
「I 休を 1 つの リ丨 数と して 扱う こと もで きます し、 次のように 2 つの メンバ 変数、 x と y を 
利用して、 x 座標 や y 座標を 個々 に 扱う こと も 《«f 能です。 

void CPasteView: :OnLButtonDown(UINT nFlags, CPoint point) 

{ 

int x, y; 

x = point, x; //point から x 座摞を 得る 
y = point. y; //point から y 座摞を 得る 
• • • 

さて、 マウス メッセージを 処柙 して Toothpaste グラフィックスを 描く 了贴 は、 要す 
るに 左 ボタンが 押されて いる 間は マウス カーソルの 移© パ こ 介 わせて M 形を 描き、 ノ丨ミ ボ 
タンが 離されたら 描丨 丨丨丨 i を やめる、 簡 中. にいえば これ だけの ことです。 そこで ClassWiz 
ard を 使って、 WM_LBUTTONI)()WN メッセージ、 VVM.MOUSEMOVE メッセージ、 
WM-LBUTTONUP メッセージに、 それぞれ リス 卜 4-2 のよう な メッセージ ハンドラを 
割り 肖て ます。 なお 処理 内稃が _ilf 丨丨衣 ホに かかわる ものな ので、 ハンドラは CPasteView 
クラスに 作成し ます 。クラス 名 才ブジ ヱクト II) メッセージの 組は 表 4-2 に/ ji します。 



クラス 名 


オブジェクト ID 


メッセージ 


メッセージ ハンドラ 


CPasteView 


なし （ CPasteView を 選択） 


WM.LBUTTONDOWN 


OnLButtonDown 


CPasteView 


なし （ CPasteView を 選択） 

I 


WM.MOUSEMOVE 


OnMouseMove 


CPasteView 


なし （ CPasteView を 選択） 


WM.LBUTTONUP 


OnLButtonUp 



表 4-2 Toothpaste グラフィックを 描く メッセージ ハンドラ 
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マウス メッセージの メッセージ ハンドラ （ Paste View, cpp ) 

BOOL ButtonDown = FALSE; 

void CPasteView: :OnLButtonDown(UINT nFlags, CPoint point) 

{ 

CDC* pDC = GetDCO; 

GrowLine(pDC, point); // マウス 力一ソルの 位 ■に 黒丸を 表示す る 

ReleaseDC(pDC) ; 

ButtonDown = TRUE; // 左 ボタンが 押されて いる ことを 示す 

> 

void CPasteView: :OnMouseMove(UINT nFlags, CPoint point) 

{ 

CDC* pDC = GetDCO; 

if (ButtonDown) // 左 ボタンが 押されて いれば 

GrowLine(pDC, point); // マウス 力一ソルの 位 ■に果 丸を 表示す る 

if (PointList.GetCountO >= 10) // キューの 長さが 10 以上なら 

ShrinkLine(pDC); // 白 モヤに 果 丸の 後を 追い かけさせる 

ReleaseDC(pDC) ; 

} 

void CPasteView: :OnLButtonUp(UINT nFlags, CPoint point) 

{ 

CDC* pDC = GetDCO; 

while (IPointList.IsEmptyO) // キューに 残って いる 座摞の 後始末 

ShrinkLine(pDC) ; 

ReleaseDC(pDC) ; 

ButtonDown = FALSE; // もう 左 ボタンは 押されて いない ことを 示す 

> 

この ブロ グラムの ポイントは、 左 ボタンの 状態を 示す ために ButtonDown という フラグ 
を川总 して、 \VM__LBUTTONDOWN メッセージ ハンドラと、 WM_LBUTTONUP メッ 
セージ ハンドラに よって、 この フラグの 侦を TRUE あるいは FALSE に 設定して いると こ 
ろです。 これは マウス 人力を 処理す る常莛 手段で も あり、 党え て おくと よいでしょう。 

次に ダブル クリック メッセージを 処理す る 例と して、 も •ボタンの ダブル クリックで I 由丨曲 • 
が クリア される 機能を この ブロ グラムに 追加して みましょう 。こちらの 動作は 非常に 串. 
純で、 WM_RBUTTONDBLCLK メッセージを 処理す る リス 卜 4-3 のよう な ハンドラを 
CPasteView クラスに 追加す る だけです 。メッセージ ハンドラは 表 4-3 のよう な 指定で 作 
成して ください。 
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クラス 名 

— ■ ■— ■ .J- 


C Paste View 


オブジェクト ID 


なし （ CPasteView を 選択） 


メッセージ 


WM.RBUTTONDBLCLK 



表 4-3 右 ボタンの ダブル クリックを 処理す る メッセージ ハンドラ 



リス 卜 4-3 右 ボタンの ダブル クリックを 処理す る メッセージ ハンドラ （ PasteView.cpp) 

void CPasteView: :OnRButtonDblClk(UINT nFlags, CPoint point) 

{ 

CDC* pDC = GetDCO; 

CRect rect; 

CBrush eraser (GetSysColor (COLOR WINDOW) ) ; // 画面 消去 用 ブラシの 用意 

GetClientRect (&rect) ; // クライ アン 卜铭 域の 座檷を 得る 

pDC->FillRect(&rect, &eraser) ; //eraser ブラシで 逢り つぶす 
ReleaseDC(pDC) ; 



リスト 4-3 は、 CDC::FillRect 閲 数を 利 州して、 クライアント 領域 全体を eraser に 指定 
した ブラシで 峨 りつぶ します。 eraser ブラシは システム カラー COLOR_ WINDOW (ウイ 
ン ドウ •色） の ソリッド ブラシです。 このように システム カラーを 利用す ると、 Windows 
の コントロール パネルで ウインドウ 竹以 色が どのように 設定され ていても、 かならず その 
色で 丨叫丨 〖丨丨 クリアが 行われる ことになります。 

•マウスの キヤ プ チヤ 一 

マウス メッセージは、 通常は マウス カーソルの 饩ド の ウインドウに 叫けて 送られます 0 
いい 換える と、 ウインドウが マウス メッセージを 受け取れ るのは、 その ウインドウ 上に マ 
ウス カーソルが ある 坳介に 131 られ ます 0 

たとえば 前項の Paste ブロ グラムを 使って、 こんな 案 験を してみ ましょう 。まず ボタン 
を 押した まま マウス カーソルを クライアント 領域の 外まで 動かします 。そして そこで ボタ 
ンを 離し、 押び クライアント 領域の 中に マウス カーソルを M します。 すると ボタンを 押し 
ていない にもかかわらず、 マウスの 移動に つれて 丨ズ丨 形が 描かれて しまいます （図 4-4)。 

これは、 前 项の Paste プログラムが 、「押した ボタンは その ウインドウの h でかなら ず 離さ 
れ る」 ことを 前提と して ButtonDown の侦を 竹理 していた からです。 ところが クライアント 
領域の 外部で ボタンを 離す と、 ビュー 才 ブジェク 卜に ボタン アップ （ WM_LBUTTONUP) 
メッセージが 送られな いため、 CPasteView::OnLButtonUp 関数が 実行され ず、 Button 
Down 変数の 侦 が丨丨 •: しく 史新 されません 0 
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図 4-4 クライ アン 卜 領域 外で ボタンを 離す と不 B 合が 起きる 



このような 問 逝を 避ける ために、 マウスの キャプチャー （Capture: M 独） という 機構が 
川 众 されて います。 これは 簡 丨 "•にいう と、 特记の ウィンドウに マウスを ムイ 丨 •させ、 すべて 
の マウス メッセージを 受け取らせよう という ものです， 

マウスを キヤ プチ ヤーした ウインドウは、 デ ィス ブレイ I •.のど こに マウス カーソルが 位 
阶 していても、 かならず マウス メッセージを 受け取る ことができます 。その代わり 他の ウィ 
ン ドウには マウス メッセージが いっさい 送られなくなります。 

この Paste プログラムの 坳介 なら、 ノ r : ボタンが 押された （ WM_LBUTT()NI)OWN を受 
けた） 時点で ビュー オブジェクトが マウスを キャプチャーして しまえば、 あとは マウスが 
どこに あろうと も かならず WVLLBUTTONUP メッセージを 受け取る ことができ るので、 
確灾に ButtonDown 変数の 侦が Ui 新で きます 。ただし キャブ チャ一した ままでは 丨由 | •曲 •上の 
他の アブリ ケー シヨ ン の； 行が 小 町 能になります から、 ボタンが 離されたら キャブ チャー 
を リリース （解除） する こと も 忘れて はいけ ません。 

キャ プチ ャーの 開始と 終 H こは、 C WnchSetCapture 間数 および KeleaseCapU 丨 nHitl 数 
を 使います （ReleaseCapture 閲 数は MFC の 問 数では なく Windows API)。 マウスの キャ 
プチ ャー/リリースを 使った ブロ グラムは リス 卜 4-4 のようにな ります。 アミが かかった 
部分が 追加した 简 所です。 
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リス 卜 4-4 マウス キャプチャーの 修正を 加えた メッセージ ハンドラ （ PasteView.cpp) 

void CPasteView: :OnLButtonDown(UINT nFlags, CPoint point) 

{ 

CDC* pDC = GetDCO; 

GrowLine(pDC, point) ; 

ReleaseDC(pDC) ; 

ButtonDown = TRUE; 

SetCapture (); // — キャプチャー 開始 

} 

void CPasteView: :OnLButtonUp(UINT nFlags, CPoint point) 

{ 

CDC* pDC = GetDCO; 

while ( IPointList • IsEmptyO) 

ShrinkLine(pDC) ; 

ReleaseDC(pDC) ; 

ButtonDown = FALSE; 

ReleaseCaptureO ; //— キャブ チヤ — 終了 



| •.記の 変 史 を 加えた ブロ グラムを コンパイルし、 灾 行して みて ください 。これなら ば、 
マウスを ビュー ウインドウの 外に 移勋 しても、 さらに そこで ボタンを 離しても、 ブロ グラ 
ムの勋 作に 支障はありません 0 

籲 マウス カーソルの 位置の 取得と 変更 

マウス カーソルの 位丨？ i を プログラム 中で 説み 取ったり 変 史 する こと も丨 ij* 能です 〇 现你 の 
マウス カーソルの 位 沢を •调 ベる には、 Windows API として 提供され ている GetCursorPos 
丨划 数を 利) U します 。この間 数を 次のように 火む すると、 POINTS 造 体の 変数 point(MFC 
を利⑴ した プログラミング 说 境では CPoint クラスの オブジェクトを 使っても よい） に、 マ 
ウス カーソルの 位 敗 が 得られます。 

POINT point; // 「 CPo 丨 nt point 」 としても よい 
GetCursorPos(&point) ; 



また 次の よつ に SetCursorPos 関数 （これ も Windows API) を 実行す ると、 指定した 座 
標に マウス カーソルが 移動し ます。 この場合は POINT 構造体と してでは なく、 x 座標と y 
峨 標を 別々 にり •えます。 



int x, y; 

SetCursorPos ^.x , v ノ； 
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GetCursorPos 関数 や SetCursorPos 問 数で 扱う マウス カーソルの 位!^ は、 スクリーン 座 
標と 丨ゆ ばれ、 丨由 iif 丨 丨のノ ド: I. 隅を® 点と します。 この スクリーン 崦檔 と、 戈 際の ウィンドウの クラ 
イアン ト 領域の 座標 （クライアント 座標） を 相/！: に 変換す るた めに、 CWncbScreenToClient 
閲 数と C Wnd::ClientToScreen 問 数と いう 関数 も 川 立され ています。 

CWnd::ScreenToClient 間数は、 スクリーン 喵檔 を クライアント 崦檔に 変換し ます。 た 
とえば CMyView という ビュー クラスが あるとき、 次の 例は マウス カーソルが 指す 位胙に 
点を 打ちます。 

void CMyView: :StoC() 

{ 

CDC* pDC = GetDCO; 

POINT point; 

GetCursorPos(&point) ; "マウス カーソルの スクリーン 座標を 得る 

ScreenToClient(&point) ; // クライ アン 卜 座標に 変換す る 

pDC->SetPixel (point. x, point .y) ;// 指定した 座樣に 点を} 了つ 

Release (pDC) ; 

} 

その 逆に CWnd こ ClientToScreen 閲 数は クライアント 嵴標を スクリーン 座 挖 に 変換し ま 
す 。次の 例は クライ アン 卜 M 域の ノ 端から 10 ピクセル、 丨 •.端から 20 ピクセルの 位 的に、 
マウス カーソルを 移動し ます。 

void CMyView::CtoS() 

{ 

CDC* pDC = GetDCO; 

POINT point; 

point. x = 10; 

point. y = 20; 

ClientToScreen(&point) ; 

SetCursorPos (point . x , point .y) ; 

これらの 閲 数は、 キーボードで マウスの# 作を シミュレートす るよう な垛 介に、 しばし 
ば 必要になります。 只 •体 例は 次 節で 紹介し ます。 



// クライアント 座摞 として （ 10, 20 ) を 指定 

// スクリーン 座摞に 変換す る 
"マウス カーソルを 指定 座摞に 移動す る 
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4.2 キーボード 入力 



MS-DOS の プログラミングでは、 キーボード 人力と いえば getchar 関数な どの 1 文 卞 
人力 関数の 出潘 でした 。しかし Windows プログラミングでは キーボード 人力を W るに も、 
やはり メッセージを 処刊! しなければ なりません 〇 從宋 の 「キーボード 人力」 という から 
受ける イメージとは 少 々與 なる 発想が 必要です 3 

キーボードの 报作 によって 発 叱 する キー メッセージは、 人き く 2M 類に 分けられます 〇 1 
つは キーの 上げ ドげ を 知る ための キース 卜 ローク メッセージ、 もう 1 つは 押された キーの 
文字コードを 知る ための 文字コード メッセージです。 

ここでは 、前節の PASTE プログラムに キーボード 人力 機能を 追加す る ことで、 キー ボー 
ド メッセージの 总 味と 利 川" 法を U てみ る ことにします 0 

•キース 卜 ローク メッセージ 

Visual C+ + では 以 ドに/ ji す 2 つの キーストローク メッセージが 利 川で きます。 なお 
Windows には、 このほかに、 WN^LSYSKEYDOWN、 WiVLSYSKEYUP という システム 
キー （L Alt ] を 押しながら 人 乃す る キー） を処那 する ための メッセージ も# 丫丨 •: します が、 
ClassWizard は これらの メッセージに ついては サポートして いません。 



• WM_KEYDOWN: キーが 押された 

♦ WM_KEYUP: キーが 離された 

キーストローク メッセージには、 3 つの t 丨 報が 付加され ます。 たとえば WIVLKEYDOWN 
を処那 •する メッセージ ハンドラを 作成して みると、 次の ような 引数が 示されます。 

void CPasteView: : OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags) 

{ 

// WM_KEYDOWN の 処理 

> 

第 1 リ丨 数の nChar は キーを K 別す る キー コードです 。キーボード .1 •.の 個々 の キーには、 
それぞれ 與 なる キー コードが リ •えられ、 たとえば フル キーの 「[と テンキーの は キー 

コードと しては 別の 侦を 持ちます 〇 ただし、 この キー コードは ハードウェアの 递 いを 吸収 
する ために、 仮想 キーと 呼ばれる Windows の統 •キー 衣 坝で尔 されます。 

侃 想 キーの 中には 特定の ハード ウヱア でのみ 立 味を 持つ もの もあります が、 表 4-4 にボ 
す 仮想 キーは 標準 キーと して、 どんな Windows システム でも、 対丨 心する 火 際の キーが か 
ならず 存 fr: する ことが 保証され ています。 標咿 キー 以外の キー 《拡张 キー） を 穴む 仮想 キー 
一ね; は インクルード ファイル Windows.h を 参照して ください 0 
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仮想 キー 


キー トップの 対応 


VK.CANCEL 


[ Ctrl | + ! Break | 


VK.BACK 


| Back Space ] 


VK-TAB 


1 Tab | 


VK.RETURN 


I Enter] 


VK_SHIFT 


1 Shift ] 


VK.CONTROL 


1 Ctrl | 


VK.MENU 


[_Alt 」 


VK_CAPITAL 


| Caps Lock 


VK.ESCAPE 


1 Esc | 


VK_SPACE 


1 1( スペース） 


VK.PRIOR 


page Up | 


VK.NEXT 


| Page Down] 


VK.END 


LEnd] 


VK.HOME 


|Home] 


VK.LEFT 


日 


VK.UP 


m 


VK.RIGHT 


B 


VK.DOWN 


m 


VKJNSERT 


[insert] 


VK.DELETE 


[Delete] 


VK_0 〜 VK_9 


囡〜囡 （フル キー） 


VK_A 〜 VK_Z 


囚〜 0 


VK_H 〜 VK-F10 




表 4-4 


1 仮想 キーと キーボードの マッピング 



メッセージ ハンドラの 第 2リ丨 数の nReptCnt は、 丨" •[•の キースト ロークが 連続して 発生 
した 場合に、 その 冋 数を 示します。 たとえば キーボードの オート リビー 卜に よって 特逛の 
キー 人力が 連続して 行われた とき、 システムの 処理が 十分に 速く キー 人力 ごとに メッセ 一 
ジの 処理が 可能なら ば nReptCnt は 1 です が、 処理 速度が 遅い 場合は nReptCnt に 2 以上 
の侦が 人る ことがあります。 

第 3 リ丨 数の nFlags は、 図 4-5 のよう な ビット フィールドから 構成され ます。 この惝 報 
を 利用す る ことは ほとんどありません。 




L OEM スキャン コード 

^ フアン クシ ヨン キーな どの 拡張 
キーが 押されて いると 1 

し Windows が® 

L コンテ キス 卜 コード。 Alt + 他の キーが 押される と 1 
^ 関数が 呼び出される 直前に キーが 押される と 1 
L 遷移 状態。 キーが 押される と 1 

図 4-5 nFlags の ビット 禰成 

それでは、 WM _ KEYI ) OVVN を 利 川して、 PASTE プログラムに 力一ソル キーに よる マ 
ウス カーソル 移# の 機能を 沿 加して みましょう 。リス 卜 4-5 のよう な メッセージ ハンドラ 
を CPasteView クラスに 対して 作成して ください 。メッセージ ハンドラ 作成 時の 指 走は 表 
4-5( こ 小し ます。 メッセージ ハンドラの 名前は 「 OnKeyDownJ に に 決まって いるので 
竹 略します。 



クラス 名 


CPasteView 


オブジェクト ID 


なし （ CPasteView を 選択） 


メッセージ 


WM.KEYDOWN 



表 4-5 メッセージ ハンドラの 指定 



リス 卜 4-5 カーソル キーで マウス カーソルを 移動させる （ p as t e view . cpp ) 

void CPasteView: :OnKeyDown(UINT nChar, UINT nRepCnt, UINT nFlags) 

CDC* pDC = GetDCO; 

CPoint point ; 

GetCursorPos(&point) ; // マウス カーソルの 位置を 得る 

switch (nChar) { 

case VK-LEFT: point .x 3; break; // [ 叫キ - : 左 移動 

case VK 一 RIGHT: point .x += 3; break; // 卜] キ 右 移動 
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case VK_UP: point. y -= 3; 

case VK_D0WN: point. y += 3; 

default: break; 

> 

point. x += (randO 7, 5-2); 
point. y += (rand() */• 5-2); 
SetCursorPos (point . x , point .y) ; 



break; // け] キ 一： 上 移動 
break; //[i ] キ 下 移動 

// その他の キー： 何もし ない 



// 乱数を 好く 加える 

// 新しい 位 ■に マウス カーソルを 移動す る 



if (GetKeyState(VK.SHIFT) < 0) { //[Shift】 キ一が 押されて いた 場合 
ScreenToClient (fepoint) ; 

GrowLine(pDC, point) ; 
if (PointList .GetCount () >= 10) { 

ShrinkLine(pDC) ; 

} 

> 

else { "[Shift! キーが 押されて いない 塌合 

while (! PointList. IsEmptyO) 

ShrinkLine(pDC) ; 

> 

ReleaseDC(pDC) ; 



この メッセージ ハンドラを プログラムに 糾み 込む と、 カーソル キーで マウス カーソルを 上 ド 
左右に 動かせる ようになります。 また そのと きに fshifT を 押してい ると 画面に Toothpaste 
グラフィックスが 衣 示されます。 

の 利 定 には GetKeyState 間数 （Windows API ) を 利) 1丨 しています 〇 この 問 数に 
VK _ SHIFT という 引数を 0 ••える と、 現在の しを ^ の 状態を 調べ、 押されて いると 炭り 侦 
はねの 整数になります 。このように、 GetKeyState 問 数は キーストローク メッセージとは 
独立に I Shift I の 状態を 読み取る のに 便利な 閲 数です。 



•文字コードに よる キー入力 

キーストローク メッセージは 個々 の 物理的な キーを K 別す る もので あり、 文字 人力に 使 
うのには やや 不便です 。たとえば 仮想 キー VK _1 は 、 Shift , が 押されて いなければ 数す •の 
を 示します が、 が 同時に 押されて いれば 1 C を •な 味す る わけです。 

そこで、 キーボードの シフト 状態 も考礅 した 突 際の 文字コードを 得る ために) II , 6: された 
ものが、 次に 示す WM_CHAR メッセージです。 

♦ WM_CHAR: 人力され た 文字の 判定 

WMJ ： HAR 用の メッセージ ハンドラは、 キーストローク メッセージの 場合と 同様に、 3 
つの 引数を 持ちます。 
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void CPasteView: :OnChar(UINT nChar, UINT nRepCnt, UINT nFlags) 

{ 

// WM_CHAR の 処理 

> 

この場合、 第 1 リ I 数 nChar には、 仮想 キー コードで はなく 案 際の 义"} •••コードが ゲ えられ 
ます 〇 第 2 リ丨 数の nRepCnt と 第 3 引数の nFlags は、 キーストローク メッセージの リ丨 数と 
まったく N じ 意味を 持ちます。 

ここでは、 ： h :、 ：j 、 k 、 I という 4 つの キー* 2 を \VM_CHAR メッセージ ハンドラ 
で 利 定 し、 前顶の 矢印 キーで 行った ものと 同様な カーソル 移動を 実現して みます （リス 卜 
4-6 >〇 WM_CHAR メッセージ ハンドラでは、、 Shift: の 状態が 文字コードの 違いと なって 
現れ、 たとえば 小文字の r hj と 大文字の r hj のよう な 区別が できる ところに 注目して くだ 
さい。 メッセージ ハンドラを 作成す る 際の 指定は 表 4-6 を 参照して ください 0 



クラス 名 


CPasteView 


オブジェクト ID 


なし （CPasteView を « 択） 


— ■ 

メッセージ 


WM.CHAR 



表 4-6 WM_CHAR メッセージを 処理す る メッセ一 ジ八ン ドラ 



リス 卜 4-6 hjkl で マウス 力一ソルを 移動させる （PasteView.cpp) 

void CPasteView: :OnChar(UINT nChar, UINT nRepCnt, UINT nFlags) 

{ 

CDC* pDC = GetDCO; 

CPoint point; 

BOOL shift; 



GetCursorPos(&point) ; 
switch (nChar) { 
h 



case 
case } 1 
case } k 
case 1 j 
case 
case ; L 
case 
case > J 
default 




point 
break; 



shift = FALSE 
shift = FALSE 
shift = FALSE 
shift = FALSE 
shift = TRUE; 
shift = TRUE; 
shift = TRUE; 
shift = TRUE; 



SetCursorPos (point . x , point .y) ; 



break 

break 

break 

break 

break 

break 

break 

break 



//[hp 左 
// [I] : 右 

//W:T 

// [k] : 上 
// [H] : 【ShiftH ■左 
// [L】 ： 丨 Shift)+ 右 
// 【J] : [Shift]+ 下 
// [K] ： [Shift)+± 



*2 vi キー、 またの 名を rogue (ローグ） キー 〇 丸、 丄、 上、 丄が それぞれ A-:、 ド、 上、 むへの ヵー 
ソル 移動を 衣す。 





マウスと キーボードからの 入力 



if (shift) { //【SHIFT] キーが 押されて いたら ウネ ウネを 描く 
point. x += (rand() */. 5-2); 
point. y += (randO 7. 5-2); 

ScreenToClient(&point) ; 

GrowLine(pDC, point) ; 
if (PointList .GetCount () >= 10) { 

ShrinkLine(pDC) ; 

} 

> 

else { //[SHIFT] キーが 押されて いなければ キューの 処理を 行う 

while (! PointList .IsEmptyO) 

ShrinkLine(pDC) ; 

} 

ReleaseDC(pDC) ; 
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本墩 では これまでとは 少し ばかり 趣を 変えて、 デバッグに 話題を 移します。 ブロ グラマ 
に とって、 アプリケーションの 設計を 終えて、 灾 際に コー デ ィングを している ときが もっ 
とも 楽しく、 クリエ イ ティブな 作衮 をして いる ことを 货感 できる 瞬 問で しよう。 しかし ア 
プリ ケー シ ョンは 染中 的な バグ 出しと デバッグが 行われる までは 完成品とは 呼べません。 
デバッグ 前の 状態では、 絵で いえば ラフスケッチ、 文 令で いえば ド I 1 ? きが 济んだ 状態に す 
ぎない のです。 

Visual C+ +6.0 では、 ツール （デバッガ） と ライブラリ （MFC) の丨叫 If 丨丨 から バグを 取り 
除き、 バグの 発生し にくい コードを 記述す るた めの サポートが なされて います 。本窣 の H 
的は デバッグ テクニックの 紹介ではありません から、 一般的な デバッグ T •法の 解説は あり 
ません。 Visual C++ の デバッガの 基本的な 使い方と、 MFC に 用意され た デバッグ 川 クラ 
スや IKJ 数の 使い方を 解説し ます 。これまで ソースコードと にらめつ こばかり して デバッグ 
していた ノア も、 ちょっと 遠 M りには なります が本荜 の 知識を 身に 付けて、 効枣 的に デバ ッ 
グを 行える ようになり ましよう。 

5.1 デバッガ 



どんなに 俊秀な ブロ グラマで も敁 初から バグの ない コードを 普く ことは できません。 優 
れた コードを 邦 く ブロ グラマは、 デバッグ にも M けて いるものな のです。 

デバッグの 際に、 もっとも 浓本的 かつ 強力な ツールと して 役立つ のが デバッガです 。デ 
バッガ を 使えば 実行中の アプリケーションを 指定した 简 所で 停 丨 h し、 その 時点の 変数、 メ 
モリ、 コール スタック （間数の 呼び出し 経路） の 内界を 参照す る ことができます。 これを 使 
え ば、 いちいち コードの 中に 変数の 倘を 出力す る デバッグ 用 コードを 塊め 込む 必要 も あり 
ません。 また 停丨 h した 筒 所から、 ソースコードを 1 行 1 行 ステップ 実行して、 そのたび に 
どのような 変化が 起こった のかを 確かめる ことができます 。さらに デバッガを 使って アブ 



5 デバッグして みよう 



リ ケー ショ ンを灾 行して いると きには、 エラーで アプリケーションが 終 r してし まっても、 
どの简 所で k 沿 •が 発 十. したの かを ソースコード ウインドウに 示して くれます:， 

鲁デ バッグの 下 ごしら え 

さきほど デバッガを ツールと 呼びました が、 Visual C+ + では デバッガが 統合 環境で あ 
る Developer Studio に 穴 まれて いて、 中 •独の ツールと して 存在して いる わけでは ありま 
せん。 メニューの [ビル ド]- [デバッグの 開始] 一 [戈む] を クリック する ことで、 デバ ッ 
ガを 使って、 现 丫丨 •: の 作 龙屮 プロジェクトの デバッグが 開始され ます。 ただし、 デバッガを 
使うた めには あらかじめ プロジェクトを デバッグ Uf 能な 状態に ぶして おく 必 •松が ありま 
す。 すなわち、 プロ ジヱ クト惝 成を デバッグ 川に 设记 します。 

MFC AppWizard を 使って プロジェクトを 作成した 垛 介、 2 つの プロジェクト 構成が H 
動的に) N 总 されます。 たとえば 「bugj という 名前の プロジェクトを 作成した 坳 介、 「bug 
- Win32 Re 丨 ease」 と 「bug • Win32 Debug」 という 2 つの プロジェクト 構成が 作成され ま 

す。 坝作 、どちらの 成で 作衮 をして いるかは、 ビル ド ツール バー （図 5 - 1 ) か メニューの 
[ビル ド]- [惝 成] (図 5 - 2 ) で 確 ••忍す る ことができます 0 




図 5-1 ビル ド ツール バー 




図 5-2 プ □ジェ ク卜撟 成 



プロジェクトを ビル ド するとき には、 どちら かの プロジェクト 惝成を 使う わけです が •、 
デバッガを 使って デバッグす るた めには、 [Win32 Debug] という プロジェクト 構成で ビ 
ルドを して おく 必 炎が あります 3 つまり デバッガを 起勋 する ためには、 

1 •ビル ド ツール バーで、 または [ビル ド] 一 [アクティブな 構成を 変 史] を 選択す ると 衣 
氺 される [偁 成] ダイアログ ボックスで プロジェクト 構成を 「Win32 Debug」 に 変! 11 
2 •ビル ド ツール バーで、 または [ビル ド] 一 [ビル ド] で プロジェクトを ビル ド 
3 . ビル ド ツール バーで、 または [ビル ド]— [デバッグの 問 始]- [义 行] で デバッグを 
開始 
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という f •船を 蹐 むこと になります。 もっとも MFC AppWizard で プロジェクトを 作成 
しため: 後は [Win32 Debug] が アクティブに 設定され ている ので、 そのまま デバッガを 起 
励す る ことができます。 

Debug 構成と Release 構成 

ここで 户備 知識と して、 プロジェクト 構成に ついて 解説して おきましょう。 プロジェクト 
構成とは ビル ド 時に おける 設 走を まとめた もので、 これを w り抒 える ことで 必炎に 応じた 
火 行 ファイルを 作成で きる ようにし ています 。たとえば MFC AppWizard を 利 川 すれば、 
Debug と Release という 2 つの プロジェクト tft 成が 作成され ます。 この 2 つの ブ ロジェ ク 
ト構 成は、 コーディング 中は プロジェクト 構成 Debug を 利 叩し、 义成 後には ブ ロジェ ク 
ト構成 Release を 利 叩す ると いうよう に 使い分け ると、 丨丨 的に 応じた； 行 ファイルが 作成 
される という わけです。 

Debug と Release の 2 つの プロジェクト 構成を 使い分ける 指針は 椒 めて 艰 純で 迷う こと 
のない ものです が、 なぜ 使い分けが 必 贤 であるかは z パになる ところでしょう。 プ ロジェ ク 
ト構 成の 設记 内界は メニューから [ブロ ジヱク 卜]- [設定] を 選択す ると 衣 示される [ブ 
ロジェ ク卜設 足] ダイアログ ボックスで 確, 忍す る ことができ るので、 これを 比較して みま 
しよう。 共通す る設 走拟丨丨 について は 竹 略す る ことにして、 表 5-1 に W •なる 点に ついての 
みまと めました 0 



投定 項目 


Debug 


Release 


出力 ディレクトリ 


Debug 


Release 


プリプロセッサの 定義 


.DEBUG 


NDEBUG 


デ バック 情報 


生成す る 


生成し ない 


最適化 


しない 


する （実行 速度 優先） 



表 5-1 プロジェクト 禰成 Debug と Release の 違い 



以丨 •.の 違いに ついて、 1 つ 1 つ 解 •说し ていく ことにしましょう 

まず m 力 ディレクトリで すが、 これは ビル ド 時に 作られる. OBJ ファイル や. RES ファ イ 
ルと いった 屮問 ファイル、 それに 鉍 終 的に 作成され る义行 ファイルの 敗き 場所と して 使わ 
れる ディレクトリです ： これらの ファイルは プロジェクト 成 ごとに W •なる 内 W で 作られ 
るた め、 別々 のフ ォルダに 保/ f: されます 。こうして おかないと 、アクティブな プロジェクト 
構成を W り枰 えても、 すべての ファイルの リ コンパイルが 行われずに、 Debug 川 オブジェ 
ク 卜と Release 丨 11 才 ブジェク 卜が 浞丫丨 •: した まま ビル ドされ てし まう ことがある からです。 

ソースファイル 屮 では# define ディ レクテ イブを 使って マクロを 定義で きます が、 これ 
と M じこと を プロジェクト 構成で も 設定す る ことができます。 MFC AppWizard が 生成し 
た プロジェクト 構成では、 Debug と Release の丨山 j 力で あらかじめ WIN32、 WINDOWS, 





図 5-3 出力 ディレクトリの 投定 （[一般] タブ） 

_AFXDLL の 3 つの マクロが それぞれ 値を 持たない マクロと して 定義され ています。 こ 
れら は丨: •に システム インクルード ファイルで 参照され ます。 また これに 加えて Debug で 
は _DEBUG が、 Release では NDEBUG が それぞれ 定 在され ています 。この 2 つの マクロを 

#ifdef ディ レクテ ィブで 参照す る ことによって、 ソースコード 中で どちらの プロジェクト 構成 
で ビル ドされ ている のかを 判断す る ことができます。 たとえば、 MFC には c 〇 b j ect::Dump 
仮想 メンバ 間数の ように プロジェクト 構成 Debug で ビル ド するとき にの み定 在され るメ 
ンバ IKJ 数が 存在し ます。 これらの 仮想 メンバ 関数を オーバーライド するとき には かならず 

#ifdef .DEBUG 

void CmyView: :Dump(CDumpContext& dc) 



#endif 

のように —DEBUG マクロを 参照し ます。 とくに 解説 もせずに 来ました が、 これまでに MFC 
App Wizard を 使っ て 作成した プロジェクトの 中には まさに これと同じ コードが 含まれて 
いたのです。 

プロジェクト 構成 Debug で ビル ドした 実行 ファイルは、 デバッガを 使って ソース ファ イ 
ルを 参照しながら デバ ッグす る ことができます。 これは ビル ド 時に 実行 ファイル に加えて、 
デバッガが 参照す る デバ ッグ 情報を 生成して いるた めです。 ただし デバッグ 情報の サイズ 
は 大きく なりやすく、 また 実行 ファイルの サイズ も 大きく なって しまうた め、 デバッグに 
しか 利用し ない 情報を 常に 生成す るのは ディスク スペースの 無駄と なります し、 ビル ドス 
ビー ド も 低 ドし ます。 そこで プロジェクト 構成 Debug のとき にの み デバッグ 情報を 生成す 
る 設定が なされて いるので す。 なお デバッグ 情報は 拡張 子が PDB の ファイル として、 出力 
ディ レクト リに 作成され ます。 
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プロジェクト 構成 Debug での ビル ドは、 プリプロセッサ による デイ レクテ イブ （#ifdef 
など） の 処理、 コンパイル （.OBJ ファイルの 作成）、 リンク （.EXE ファイルの 作成） とい 
う ステップで 行われ ますが、 Release による ビル ドでは、 リンクの 手前に 敁適 化と 呼ばれ 
る 処理が 行われます （设適 化が サポートされ るのは、 Professional Edition 以上 〇 Standard 
Edition では サポートされ ない）。 敁 適 化の f •法は 非常に 複雑で あり、 ここで 簡申 •に 説明で 
きる ものではありません が、 その II 的は より 实行 速度が はやく、 より ファイル サイズの 小 
さな 実行 ファイルを 作る ことです 。ただし W •適 化には 時 問が かかります 。まだ デバッグ 中の 
コードで あれば、 灾行 速度の 速い 灾行 ファイルを 作る ことよりも、 開発 サイクルを 钳 縮す 
る ことの 方が Ji: 要です から、 W 適 化は 必要ありません 。そのため プロジェクト 構成 Release 
でのみ 蚣適 化が 行われる 設走 がな されて いるので す 0 
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図 5-4 プリプロセッサの 定 親、 デバッグ 情報、 ■適 化 （ [ C / C + + ] — [一* 8]) 



以上が 2 つの ブロ ジヱ クト 構成の 違いです 。プロジェクト 構成の 設定 顶 H を変史 しない 
限りは 铽に するべき 瑣ト丨 はありません か' マクロ- DEBUG と NDEBUG について は あとで 
登場し ますので 党え ておいて ください 0 

籲ビ) レ ドエラ 一 

それでは 実際の デバッグ 作業を 通して デバッガの 使い方を 修得す るた めに、 1 っブ ロジェ 
クトを 作成し ましょう 。これまでと M じように MFC AppWizard を 使って、 次の 手順に 
従って bug プロジェクトの スケルトンを 作成して ください 。ここでは、 ダイアログ ベー 
スの アプリケーションを 作成して みます 。ダイアログ ベースの アブリ ケー シ ョンでは、 ド 
キ ュメン ト- ビュー •アーキテクチャに 依存し ない プログラムを 作成す る ことができ、 また 
Visual Basic のように ウィンドウ （フォーム） の 上に 联 接 コントロールを 貼り付けて いくこ 
とで ユーザー インターフェイスを 簡皐に 作成す る ことができます 。以降の 処理は、 ダイア 
ログ ボックスの 扱いと ほぼ 同様な ので、 ここでは 詳しい 説明は 杏き ます。 



デバッグして みよう 






1. 新規 作成 ダイアログ ボックスから [MFCAppWizard(exe)] を 選択し、 プ ロジェ ク 
ト 名に bug を 人力す る 

2. MFC AppWizard の ステップ 1 で、 [作成す る アプリケーションの 棟 類] に [ダイア 
ログ ベース] を 選択 

3 •く 終，〉 ボタンを クリック 

次に MFC AppWizard が 屯 成した ダイアログ ボックス IDD _ BUG _ DIALOG を褊染 し 
ます。 ワーク スペース ウインドウで [ResourceView] タブを クリックして リソースの 一 1 ^ 
Jr 衣ポ し、 Dialog フ オルダの ドに ある II ) I )_ BUG _ DIALOG を ダブル クリックして くださ 
，、。ダイアログ エディタが 起動したら、 図 5 -5 および 表 5 -2 に， ji すよう に 2 つの エディ ッ 
卜 ボックスと 1 つの ボタンを 配 敗し ます。 



IDC FILENAME 




図 5-5 IDD-BUG— DIALOG 



イット ボックス 変更な し 



IDCJEXT 



イット ボックス 



IDC-OPEN 



ボタ 



複数 行、 

垂直 スク 
チェック 

キャブ シ 



ロール バー、 水平 オー 



一、 垂直 才ー トス クロ 



く （ &0 ) ] を 入力 






表 5-2 コ 



配置したら、 IDC_OPEN ボタンに メッ • 
ardBar を 使って、 次の 項丨 | を 選択した あ: 
セージ ハンドラの 追加] を 実行し ます。 す. 



ドラを 割り当てます。 これには’ 
キス トメ ニューから [ Windows 
ス CBugDlg 用の Windows メッ 





ジ および イベント ハンドラの 新規 作成： ダイアログ ボックスが 表示され るので、 < ハンド 
ラの 追加〉 ボタンを クリックし、 CBugDlg :: OnOpen メッセージ ハンドラを 作成し ます。 



CBd 9 DI 9 を « 択 IDC—OPEN を 道 択 




rYTor irMjeuxv aoo.euo.oiAioQ} 

WxWWIfcf.®) 

図 5-6 WizardBar 

次に 作成され た 空の メッセージ ハンドラに リス 卜 5-1 に 示す コードを 入力して ください。 
ストーリー の邡介 上、 总 N 的に バグを 含ませて あります 。铽づ いてし まった W 明な 読者 も 
多い とは 思います が、 ここは ひとまず 黙って おいてく ださい （簡中 •にいえば、 リス 卜 5-1 
にポ すと おりに コードを 人力して ください ）〇 



リス 卜 5-1 CbugDlg::OnOpen メンバ M 数 （ IDC_OPEN の BN_CLICKED メッセージ ハンドラ ) 

void CBugDlg : : OnOpen ( ) 

{ 

CFile f; 

CString filename; 

( (CEdit*)GetDlgItem( IDC.FILENAME) ->GetWindowText (f ilename) ; 
if (!f .Open(filename, CFile : rmodeRead) ) { 

AfxMessageBox(_T (" ファイルが 見つかりません"））； 
return; 



UINT length = f .GetLengthO ; 

TCHAR* p = new TCHAR [length] ; 

if (f. Read (p, length) != length) { 

AfxMessageBox し T (" 妩 み 込みに 失敗し ました"））； 
return; 



((CEdit*)GetDlgItem(IDC.TEXT))->SetWindowText(p) ; 



f -Close () ; 
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ク しても かまいません。 

エラーが 発生した 行の 内稃は 次の ような ものです 0 
( (CEdit*) GetDlgItem(IDC_FILENAME) ->GetWindowText (filename) ; 

なぜ、 この 行で エラーが 発 也した のでし ようか？ 先に 正解を 示して しまう と、 この 行は 
鬼は 次のように なって いなければ ならない のです。 つまり、 パーレンを セミコロンの 前で 
はなく、- > の 手前に 人力す る 必要が あります。 



((CEdit*)GetDlgItem(IDC_FILENAME))->GetWindowText (filename) ; 



プログラムを# いている ときには、 GetDlgltem 問 数で エディット ボックスを 取得して、 
それに 対して Get WindowText 問 数を 实 行し、 ファイル 名を 取得す ると 考えて いたわけ で 
す。 なのに、 なぜ この エラーが 先の ように 報告され たの か、 少 々鉍 くなります が コンパイ 
ラの 言い分を 代弁して みましょう 0 

次に 示す のは コンパイラから U た 178 行 丨丨 の 内科です 。コンパイラ はまず 1 行 （セ ミコ 
ロンまで） を 分解 能な パーッに 切り分けます。 すると 

( ( CEdit* ) GetDlgltem ( IDC.FILENAME ) -> GetWindowText ( filename ) 

のようになります。 次に C++H 語の 文法に 従って パーツを 糾み 合わせて いきます。 ここ 
では 演 灯/ •の 俺 先) (« 位に 從っ て、 俺 先 順位の, い 順に 組み合わせを 進めて いきます 。まず 
ここで 分坳 する もっとも W い 俺 先 順位を 持つ 演? TY •は、 問 数 呼び出しに 使われる パーレン 
です （これ も演 の 1 つです） 。そこでまず GetDlgltem メンバ 問 数と GetWindowText 
メンバ 閲 数の 呼び 川し に 使われて いる パーレンを つなげます 。結果は 次のようになります 0 

( ( CEdit* ) GetDlgItem(IDC_FILENAME) -> GetWindowText (filename) 

これは 問題ありません。 次に 尚い 演 灯 子は メンバ 参照に 使われる- > です 。そこで GetDl 
gltem メンバ 閲 数と GetWindowText メンバ 閲 数の ブロックが つながります 

( ( CEdit* ) GetDlgItem(IDC_FILENAME)->GetWindowText(filename) 

この 時点です でに ブロ グラマの 总丨ズ I とは 舆 なった 解釈が なされて いる ことが わかる でしょ 
うか？ 本来なら ば GetDlgltem メンバ 閲 数の CWnd*M の 返り 値を CEdit* 削 こ キャストし、 
それから GetWindowText メンバ 閲 数を 参照す るは ずでした。 ところが キャストが 行われ 
る 前に-〉 による 参照が 行われて しまった ため、 CWnd::GetWindowText メンバ 閲 数が 呼び 
出される と 解釈され てし まっている のです。 しかし 誤った 解釈が されて いるに も かかわら 
ず、 たまたま CWnd クラスに も CEdit クラスと 同じ GetWindowText メンバ 関数が 存分: 
したため、 これを コンパイラは エラーと 判断で きなかった のです。 

そこで コンパイラは 何食わぬ顔 をして 次の 解釈に 進みます 0 次は （CEdit*) による キャスト 
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が処种 •されます が、 この 時 办で 初めて コンパイラは エラーを 検出し ます。 C WnchGetWindow 
Text メンバ 関数の 返り 値は void であるた め、 これを CEdit * 型には キャストで きないから 
です （ void は 返り 侦 なしを 末し ますから、 む: 丫丨 •: しない 侦の喂 を 変換す る ことは でき ませ 
ん ）〇 これが エラーメッセージの 1 行 丨| の丨丨 •: 体です 。さらに 残った 先頒の パ一レンを 解釈し 
ようと 試みます が、 対応す る パーレンは 存 化しない ため、 「敁 後に パーレンがない よ」 とエ 
ラー メッセージの 2 行 丨丨 が 出 乃 された のです。 

このように コンパイラは できる 版り C + + •丨 •訪 の义 法に忠 火に 解釈し ようと 試みます。 
これに 文 •敗す ると コンパイラは エラーメッセージを 出力す るので すが、 すでに 兄た ように 
これが かならずしも プログラマに とって 丨 び 接々 益な 悄报 とは 丨3| ら ない のです。 エラー メッ 
セージを 丨 I : 確に 説み 取る ためには コンパイラの 気持ちに なって そえる ことです。 このと き 
参 冬になる のが、 エラー コードの ヘルプ ドキュメントです。 アウトプット ウィンドウの エ 
ラー メッセージの 行に カーソルを 沢いて [ F 1 _i を 人力す ると、 その エラーが, & 味す ると こ 
ろを 解, 兑 した ドキュメントが 衣 小され ます 0 例 も 交えて 詳しく 解説され ている ので、 ぜひ 
沾 川して ください。 

籲 完成？ ちょっと まった！ 

バグの 股 W も 解決" 法 も 明らかになった ところで、 前節の バグを 修正して、 改めて ビル 
ドして ください 。今度は 無 w ビル ド も 終 r した ことでしょう 。そこで できあがった 灾行 ファ 
イ ルを、 デバッガを 使って 起 勅し ます。 このためには、 メニューから [ビル ド]— [デバ ッ 
グの閒 始]- [火む] を 選択し ます。 すると 涔 M に 起# した 場合と M じように、 ブ ロジェ ク 
卜 bug の ダイアログ ボックスが 衣ボ されます 0 ここで 図 5-8 に/ ji すよう な 操作を してく だ 
さい。 

すると 指 走した ファイルの 丨人 J ' 押が、 ドの エディット ボックスに 衣 示された はずです。 これ 




図 5-8 Bug ダイアログ ボックス 



ECHO OFF 



これが 忮 しい 



REM 

REM 



set l 6 =c¥pro<ram files¥DevStudii 
set nckjde=c¥pr 〇 <rdm files¥Dev 5 
ET PATH=C¥WIN[ 
set term=vt100 






OK 



I 



図 5-9 おかしな 鳳 点 

で Vd 成、 といきたい ところで すが、 衣ボ された ファイルの 内矜 をよ く兑 てくだ さい 。ファ 
イ ルの 七丨 4 が 衣 示される ように スクロールさせる と、/ ii 後に いくつか おかしな 黑 A が 衣 示 
されて います。 

どうやら エディッ 卜 ボックスに ゴ ミが 浞 じり 込んで しまって いるよう です。 これは 明ら 
かに バグです から •狗仵 が必贤 です。 ここは ひとまず ブロ グラムの 火 行を 終， し、 调作 する 
ことにし ましょう 。デバッガで 起# した ブロ グラムを 終 r させれば、 r 丨勋 的に デバッガ も 
終 r します。 

このような - u # 作して いるものの 小饰 な# 作を する 類の バグの, 與仵 には デバッガの ブ 
レーク ポイント 機能が 便利です。 ソースコード 丨 ••に ブレーク ポイントを 設记 して おくと、 
ブロ グラムの 火 行が ブレーク ポイント 位胙 にさし かかる と、 灾 行が れ勋 的に 炒丨丨 •され、 デ 
バッガ に 操作が 移ります 。ここでは CBugDlg::OnOpen メンバ 関数の 中に バグの KCW が あ 
る ことは ほぼ | Hj 迪 いないので （ M しろこ こにし か コードを) £[ 加して いないの ですから）、 
CBugDlg :: On()pen メンバ 問 数の 先頒に ブレーク ポイントを 設定し、 ここから, 调作を 進め 
る ことにしましょう。 

リス 卜 5-2 ブレーク ボ イン 卜の 投定 

void CBugDlg : : OnOpen ( ) 

{ 

CFile f; // ここに ブレーク ポイントを 設定 
CString filename; 

( (CEdit*)GetDlgItem(IDC_FILENAME) ) ->GetWindowText (filename) ; 
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ブレーク ホイ ントを 設定す るた めには、 まず ブレーク 
を 移動し ます 。次に マウスの 心 •クリック により ショー 
ポイントの 挿 人/削除] を 実行し ます （図 5-10)。 



卜を 設定したい 行に カー 

ブレ 




((C£dit») 



( 5 * 



凶 5-10 フレーク ボ イン 卜の 投定 

すると ブレーク ポイントを 没 走した 行の 先頒に 亦い •が 衣 > ji され、 ブレーク ポイント ガ 
設 走され たこと を 衣します。 また •没定 した ブレーク ポイントは [榀 染]- [ブレーク ボ イン 
ト] を 突 行す ると •衣ボ される [ブレーク ポイント] ダイアログ ボックスから も 確認す る こと 
がで きます （図 5-11) 0 この ダイアログ ボックスを 使う と、 条件付き ブレーク ポイントな 
どのより 敁 度な 機能を 利用す る ことができ ますが、 詳細は マニュアルに •潔る ことにします。 

娜 I ，•— 丨械ザ 丨 I w ] 

フ VWT ノト <B> 

jr^ramv J 

図 5-11 [ブレーク ポ イン 卜] ダイアログ ボックス 

ブレーク ポイントを 设 走したら、 先と m じように デバッガを 使って プログラムを 実行し 
てくだ さい 。そして M じ 操作を 行います 。すると 今度は ファイルの 内斿 が表ポ される 前に 宠 







図 5-12 ブ □グラムが 停止した 



iper Studio が アクティブになります。 このと き货 色い 矢印が ブレー 
ソースコード 行の 先 頒 に衣ボ されます が、 これは その 行で 実行が 停 
ています （図 5-12>。 また 丨丨 丨丨 iifiH こは 変数 ウィンドウ や デバッグ ツー 
/ji されて いなかった ウィンドウが 衣/ されます （図 5-13)。 もし 変 
れ なければ、 メニューから 丨衣 小]- [デバッグ ウィンドウ]- [変 
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変数 ウィンドウには 现 在の プログラム カウンタ 位骹 （黄色い 矢印が 指して いる 位 敗） で 使 
われて いる シンボル （変数） の 名前と 値が 衣 示されて います 。衣 ボ されて いる シンボルが ク 
ラス や 構造体の 才 ブジェク ト （または その ポインタ） であれば、 シンボル 名の 丨 ): j •に 「+」 記 
り •が 表示され、 これを クリック すると その メンバの 名前と 侦 ま でも 参照す る ことができ ま 
す。 また 変数 ウィンドウには 問 数 呼び出し 後の 返り 値 も 表示され ます 。ブレーク ポイント 
を 使った デバッグでは 、突 行中に 変数の 侦が どのように 変化した のかを j £[ いかける ことで 
バグを 発見す る ことになります から、 もっとも 取 费な ウィンドウです。 



^ (CBucOic 00 p«nO 
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^Dial 〇 t 〇 rCmd^(^s<ne<3 r^t v 〇 «J • AFX^CMDHANDlERINFO •) ニ ] 



図 5-14 OnOpen 関数の コール スタック 



また 変数 ウインドウ にはもう 1 つ、 《r (要な* w 報が [コンテキスト] ドロップ ダウン コンボ 
ボックスに 衣 示されます （図 5-1 4 > 〇 ここには 现丫丨 •: の ブロ グラム カウンタ 位旳の 閲 数名が 
衣 示されて いますが 、ドロップ ダウンす る ことによって、 どのような 閲数 呼び出しを 経て 
現在の 位 沢に ブロ グラム カウンタが 進んで きたの かを 知る ことができます 。このような 悄 
報を コール スタックと 呼ぶ こと もあります 。ドロップ ダウン 内では ドに 衣 示される 問 数が 
上に 衣 示される №1 数を 呼び出した ことを 衣して います。 ある 問 数を 呼び出す コードが 1 か 
所 だけで あれば あまり 取 要な 惝 報ではありません が、 极 数の 場所から 呼び出される 場 介に 
は、 コール スタックは、 どのような 条件で バグが 発觉 する のかを 特走 する ための イ丨 •益な 悄 
報と なること が 少なくありません。 

さて、 このまま ブロ グラムを 柃丨丨 •.して おいても バグを 発 U できない ので、 ここから ステ ッ 
ブ 実行を 行います 。ステップ 実行とは ソースコードを 1 行 突 行す るた びに 実行を 停 土す る 
機能です 〇 ステップ 実行を •丨 丨丨丨 実行す ると ブロ グラム カウンタが 1 行進み、 変数 ウィンド 
ウの 内容が 変化し ます。 このと き 侦が撙 き 換えられた 変数が あれば、 赤い 文字で 表示され 
るよう になります。 ところで ステップ 灾 行には 次に あげる 3 神: 類が 存 介: します 。通常は ス 
テッ ブ才ー バーを 実行し、 必要に応じて ステップ イン、 ステップ アウトを 案 行 するとい う 
使い方を します。 これらの 操作は デバッグ ツール バーから 行います （図 5-1 5)。 
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図 5-15 デバッグ ツール パー 



•ステップ イン 

プログラム カウンタ 位択に 間数 呼び出しが あれば、 その 閲数 内に ブロ グラム カウンタ 

を 進める 

•ステップ オーバー 

プログラム カウンタを 1 行進め る （間数 呼び出しが あれば、 その 間数の 処押が 終广し 

た 時点まで ブロ グラム カウンタを 進める） 

•ステップ アウ 卜 

ブロ グラム カウンタ 位阶の 間数が 終 r すると ころまで ブロ グラム カウンタを 進める 

それでは ブレーク ポイント 位} g から ステップ オーバーを 7 问灾 行し、 CFile::Read 問 数の 
呼び出しが 終 r した 時 A まで プログラム カウンタを 進めて ください。 すると 指定した ファ 
イ ルが メモリに 説み 込まれます から、 これを 凋 作す る ことにします。 このと き ファイルの 
内袢は ポインタ 変数 p が 指し 尔す アドレスに 説み 込まれて いますが、 贱 念ながら 変数 ウィ 
ン ドウの 変数 p の «« には、 変数 p が 指し ポす メモリの 内 料は 数丨 •バイト 分し か 衣, p されて 
いません 。そこでもう 1 つの デバッグ パ 1 ウインドウ である メモリ ウインドウを 使って メモ 
リ の内袢 を •脚 作す る ことにします。 メモリ ウィンドウを 使えば、 指定した アドレス 峋 辺の 
メモリの 内 料を 広範 丨 用に わたって 参照す る ことができます 。っまり これを 使えば 説み 込ま 
れたフ ァイ ルの ぶ; こどの ような データが 穴 まれて いるの かを 凋べ る ことができる という 
わけです 。メモリ ウィンドウを 在, ji させる ためには、 [衣 ポ]- [デバッグ ウィンドウ] 一 
[メモリ] を 選択し ます。 

メモリ ウインドウには、 [アドレス] エディット ボックスに 人ノ j された アドレスの 丨 , y 辺の 
メモリの 内 料が 衣尔 されます 。[アドレス] には 16 進数で 丨 》*丨: 接 アドレスを 指定す る だけで 



[アドレス】 エティ ッ卜ホ ノクス 16 違«« か、 変数 を 含んだ 式を 入力す る 



43 3A 50 52 4F 47 52 41 ?£ 31 父 的 B2 的 » ひ K ひ 

7E 31 5C 56 42 53 43 41 4E 2E 45 58 45 20 43 3A 5C 20 ^IWBXAN.EXE C：V 

43 3A 5C 57 49 4E 3$ 38 5C 43 4F 4 〇 4D 41 4E 44 50 20 

2F 4E 53 20 2F 57 49 4E 3$ 35 00 OA 43 3A 5C 50 52 4F /US 
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ダン ブリス 卜 エリア： 【アドレス】 で 指定され た メモリの 内容が、 16 蘧数 僅と 文字で 表示され る 



図 5-16 メモリ ウィンドウ 
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なく、 変数 ウィンドウに 衣， ji されて いる 変数を 含めた 式を 指定す る こと もで きます。 たと 
え ば ポインタ 変数 p が 参照して いる メモリの 内綷を 表示 させたい ときには 「 * p 」 と 人力し 
ます 。アスタリスクを 忘れないで ください。 .中-に 「 p 」 と 指定す ると、 ポインタ 変数 p の 値 
が 納められ ている アドレス <& p で 捋られ る アドレス〉 が 人力され たものと されて しまい ま 
す。 なお [アドレス] ボックスに キーボードで アドレスを 入力す る 代わりに、 変数 ウィンド 
ウ から シンボル 名、 または その 侦 （ポインタ 変数の 坳 介） を メモリ ウィンドウに ドラッグ 
& ドロップ する こと もで きます。 

ところで、 [アドレス] に 変数を 人ノ j した 場合、 その 変数の 侦 （アドレス） を簡 中. に 知る ガ 
法がなければ、 指 泣した アドレスの 丨人 r 作が ダンプ リストの どの位 丨 w •に 衣/ p されて いるの か 
利 断で き なくなって しまいます っ そんなと きは、 ダンプ リストの 適、 | 彳 な位阶 で- - lu | クリック 
します。 すると ダンプ リスト 丨 •.に キヤ レット （キーボードからの 人ノ j 〗 l ] カーソル （縦 棒）） が 
衣氺 されます 。この 状態で アドレスを あらためて 指定す ると、 キヤ レット 位阶の 行 頒 に 指 
した アドレスが 炎， ji されます 。ダンプ リストを スクロール させて 位 沢を 见 失って しま っ 
たと きな ども、 こうするとよ いでしょう。 

ここでは ファイルの 未 W の 状態を 知りたい のです から、 [アドレス] に 「* ( p + l engt h >」 
と人ノ J します （ lenmh は ファイルの U さを ポす 変数 > 〇 こうして 衣/ ji された メモリの 内界 
と、 指定した ファイルの 内衫を 比べて みると、 どうやら ファイルは 丨丨 •: 常に 说み 込まれて い 
るら しいと いう ことが わかります 。という ことは、 p + l engt h 以降の メモリの 内袢 まで エ 
デ ィッ 卜 ボックスに ゴミ として 人人; されて しまった という ことです。 

そこまで わかった ところで ソースコードに 1乂 って みましょう。 ここまで 追い詰めたら 
もはや 犯人は 明らかです。 II ) C _ TEXT エディット ボックスに テキス 卜を 神人す るた めに、 

CEdit::SetWindowText メンバ 閲 数を 使って いますが、 この メンバ 関数は LPCTSTR 型の 

リ丨 数を 1 つと り、 これに 指) ii された メモリの 内袢を エディット ボックスに 神 •入し ます。 問 
姐は この リ丨 数が 終端に •¥0 •を 持つ 义卞 列を 袈 求して いると ころに あります 。つまり、 ファ 
イ ルの 未 W には 1 ¥0• がありません から、 偶然 メモリ 丨 •.に 存在した •¥0 •までが ファイル サイ 
ズを 超えて エディッ 卜 ボックスに 择 •入され てし まっていた わけです。 

WW を 突き 丨丨 •.めれば あとは 简 中. です 。次のように 修丨丨 •: すれば ゴ ミが まじる ことは なくな 
ります （リス 卜 5-3)。 

リス 卜 5-3 修正した CBugDlg ::0 n 0 pen メンバ 関数 

void CBugDlg: :OnOpen() 

{ 

CFile f; 

CString filename; 



( (CEdit*)GetDlgItem(IDC. FILENAME) )->GetWindowText (filename) ; 
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if (!f .Open (filename, CFile: :modeRead)) { 

AfxMessageBox し T (" ファイルが 見つかりません ••）） ； 
return; 



UINT length = f .GetLengthO ; 

TCHAR* p = new TCHAR[length + 1] ;//•¥0 •のために +1 
p [length] = ’¥0’； 

if (f.Read(p, length) != length) { 

AfxMessageBox(_T("tt み 込みに 失敗し ました ••）） ； 
return; 



((CEdit*)GetDlgItem(IDC.TEXT))->SetWindowText(p) ; 
f .CloseO ; 



これで やっと 完成、 といいたい ところで すが、 奕は まだ バグが 残って いるので す。 この 
サンプルは このまま 次 節に 持ち越し ますので、 もうし ばらく お付き合いく ださい。 

5-2 デバッグ サボー 卜 関数 

前節で 紹介した ように、 デバッガの ステップ 実行 や 変数 参照と いった 機能は 非常に 強力 
で、 人 幅に デバッグ 効 申の 叫 上に 質献 して くれます。 しかしす ベての Ifu •において デバ ッ 
ガ だけで バグを 検出で きる かとい うと、 そうで もありません。 たとえば 前 ボ では 文字列の 
末 M を 調べる ために、 メモリ ウィンドウを 使いました 。これは 変数 ウィンドウでは 文字列 
の すべてを 表ボ させる ことができなかった からです 。このように デバッガが) lj 总 している 
各 稀: の ツールに も 得手 不得手が あります 0 先の 例では 文字列 データを 凋 ベれば よかった た 
め、 メモリ ウィンドウが 利用で きました が、 これが 数 倘の妃 列 だったら どうでしょう 。さ 
らに 、複雑な クラス オブジェクトの リンク リスト だったら？ 変数 ウィンドウに これを 表示 
させる ことは できず、 また メモリ ウィンドウで 追跡す る こと も袢 易ではありません。 

こうした デ 一夕 構造の デバッグを 行うた めには、 デバッガ だけに 頼らず、 ソースコードの 
中に データの •丨丨 •: 尚 性を 検出す るた めの、 デバッグ コードを 塊め 込む 手法が 科 効です。 MFC 
にはこう した デバ ッグ コードを サポート する クラス や 間数が? 5： 贷 に州总 されて います 3 こ 
こでは 先の プロジェクト bug を 使って、 これらの デバッグ サポート 機能を 利) 丨 J してみ ます。 
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• メモリ リーク 

数 ある バグの 神: 類の 屮 でも、 メモリ 竹 押. にか かわる バグ、 とくに メモリ リーク ほど hi 介 
な バグはないでしょう 。メモリ リークが 発 4: しても •见 プログラムは 丨ト: 常に 動き 続ける も 
のの、 ある タイミングで 突然 プログラムが w •常 終 r します 。そして 代 常 終 r した简 所が デ 
バッガ によって レポートされ たと しても、 メモリ リークを 起こして いる 行から 遠く離れて 
いる ことが しばしばです 。しかし MFC を 使って いれば、 メモリ リークが 発 少して いる こ 
とが レポート される ばかり か、 メモリ リークを リ I き 起こして いる メモリ 確保の 位 阶まで特 
定 して くれます。 

また ライブラリには オーバーランの チェック 憷惝も 川. & されて います 。たとえば new 演 
兑广を 使って 淡ぶ 数 10 の char 咽 変数の rtil 列を 確保した としましょう 。この rti! 列の 11 潘 
II の •皮ぶ に J 丨 : き 込みを 行う ことは、、 1 彳然 のこと ながら プログラミング h の エラーで あり、 
もともと その メモリに 格納され ていた 内' 作 は 破壊され てし まいます。 ところが デバッグ 川 
MFC を 利 川 すれば、 delete 演 灯， •を 使って メモリ ブロックを 解放 するとき 、オーバー ラ 
ンが発 4: した ことを 検出し、 これを レポート する ことができます 0 

このように プロジェクト 惝成 Win32 Debug を 利 川した ときに リンク される デバッグ 川 
MFC には 改岱 な デバッグ サポート 機能が 州盘 されて います 。とくに メモリ 竹现 に閲 する サ 
ポート 機能が 允 戈して います。 それだけ メモリ 竹 押. は ブロ グラマに とって 恐ろしい バグの 
泓) ぶな のです。 ところで、 プロジェクト 惝成 Win32 Release を 使って リリース ⑴火行 ファ 
イ ルを 作成 するとき には （ 丨丨: 確には _DEBUG が災義 されて いないと き）、 これらの チェック 
憷惝 はすべ て 無効になる ようになって います。 丨 •分 テストした あとに リリース 川灾行 ファ 
イ ルを 作る のです から 過 刺な チェックは 処押 .速度を 低 ドさせる だけで あり、 必要ない とい 
うわけ です。 

ここでは メモリ リークに 閲 する MFC の デバッグ サポート 機能に ついて 解説し ます。 



メモリ リークの 検出 

lW 節の 終わりで 作った プロジェクトを ビル ドし、 これを 火 行して ください。 -WJ!!] 題な 
く# 作して いるよう です が、 アウトプット ウインドウを U ると、 欠は そうで もない ことが 
わかります 。ブロ グラムを 終 r させて、 アウト ブット ウインドウの デバッグ タブを 炎/ さ 
せる と、 次の ような メッセージが 衣ポ されて いるは ずです 0 

Detected memorv leaks! 

Dumping objects -> 

C:YusrYvcproYbugYbugDlg.cpp(185) : {58} normal block at 0x00771780, 

6/^6 bytes long . 

Data: <C:YPR0GRA^1Y > 43 3A 5C 50 52 4F 47 52 41 7E 31 5C B3 B2 D9 BD 
Object dump complete. 
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この メッセージは 「メモリ リークが 発/ 1: した」 ことを 伝えて います。 メモリ リークとは ど 
こから も# 照され ていない にもかかわらず、 解攸 されずに 攸阼 されて いる メモリが む: 在し 
ている という ことです。 C+ + 言語では new 演 灯 f* を 使って メモリを 確保した 場合、 使 州 
済みに なった 時点で delete 演灯 ，•を 使って その メモリを 解攸 しなければ なりません 。その 
メモリの 解攸 を; & った坳 介、 無駄に メモリが m 代され る ことになります が、 これが メモリ 
リークです 。火 際には 丨分な メモリが 焚備 された •灯 機で アプリケーションを 勋 かしてい 
る 眼り、 メモリ リークが 発 十. しても アプリケーションの 勋作 そのものには 支 隙の ない こと 
もあります。 しかし メモリ リークは えてして メモリ 竹 列! の ミスから 発 卞 する もので あり、 
わかりにくい、 なんらかの バグの 副 作 川と して 起こる こと も 多い のです。 これは 決して U 
逃して はならない メッセージです。 

では、 宄の ェラーメッセージを •ぼしく 説明し ましょう 〇 1 つの メモリ リークは 2 行に i •度っ 
て レポートされ ます。 つまり ここでは 1 つの メモリ リークが 発 叱して いる わけです 。まず 
1 む丨丨 です が、 次の フォーマットで MWJ されて います 0 

く ソースファイル 名〉 （く 行# 号〉）： {く リクエスト# 号 >) •く オブジェクト 楊 〉 at < アドレス >, 
く サイズ 〉 bytes long 

つまり、 先の 例では ソースファイル C:¥usr¥vcpro¥bug¥bugDlg.cpp の 185 行 丨丨で 確 
保した メモリが 解攸 されて いない ことが レポートされ ている わけです 。 < リクェスト 济り •> 
は、 アプリケーションの 問始 から fl#l| 丨 丨 の メモリ 確保を 行った 咚 点での メモリ リーク かを 
衣して います 。先の 例では 58111111 に 確保され た メモリで ある ことを 衣して います 。また 
< 才 ブジェク 卜 柯> として normal block が レポートされ ています から、 これは クラスの 才 
ブジェク 卜では なく、 丨 (1 •純な 喂 として 確保され ている ことを 衣して います。 さらに その メ 
モリは アドレス 0x00771780 から 確保され、 サイズは 676 バイ 卜で ある ことが わかります。 

2 行 丨丨 には リークし ている メモリの 内 料の 先頒 16 バイト 分が 义卞と 16 進数で ダンプ さ 
れ ています。 丨山 丨汽 •は M じ データを、 形を 変えて 衣ボ している だけです。 メモリの 内界が 文 
字 列で あれば キャ ラク 夕衣ボ がイ丨 •益です し、 バイナリ データで あれば 16 進数 ダンプが 役に 
ぐ/: ちます 。光の 例では 义卞 列の 保む: に 使った メモリが リークし ていたた め、 キャラクタ 衣 
尔を U れば どういった I 丨 的で 使われた メモリで あるか 推測す る ことができます。 

以上の 怙钳 から、 メモリ リークを 解 消 する ことにしましょう 。この 垛介 、レポートされ 
た ソースコード 行に おそらく new 演灯 f が あり、 それに 対応す る delete 演 ぬ: 子が 杯 在し 
ないで あろう ことが 户想 できます から、 ともかく ソースファイルを 衣, しましょう 0 この 
ためには、 ビル ドェラ 一が 起きた 行を 衣 小させ たと きと |uj じように 、やはり： F 4 」 を 使い 
ます 。このように アウトプット ウィンドウに 衣尔 された レポートに 対しては、 すべて 厂 F4 
で ジャンプが 丨げ 能と なって います （ファイル 名と 行畨兮 が 行頭に 表示され ている 場合) 0 

ェラー 行を 农示 させる と 確かに 次の ような new 演 兑 子が あり、 これに 対応す る delete 
淡ね/ •は# がしません 。 確保した メモリへの ポインタは ローカル 変数 p に 保存され るた め、 
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CBugDl ff: OnOpen メンバ 間数が 終了した 時点で メモリ リークが 発生して しまう わけです。 

TCHAR* p = new TCHAR[length + 1]; //.W. のために +1 

そこで リス 卜 5-4 に 示す ように CBugDl ff: OnOpen メンバ 関数を 修正し ます 0 

リス 卜 5-4 メモリ リーク 解消 版 CBugDlg::OnOpen メンバ 閲 K 

void CBugDlg: :0n0pen() 

{ 

CFile f; 

CString filename; 

( (CEdit*)GetDlgItem(IDC_FILENAME) )->GetWindowText (filename) ; 
if (!f .Open(filename, CFile : rmodeRead) ) { 

AfxMessageBox(_T (•• ファイルが 見つかりません"））； 
return; 



UINT length = f .GetLengthO ; 

TCHAR* p = new TCHAR[length + 1] ;//•¥ 0 • のために +1 
p [length] = *¥0*; 

if (f. Read (p, length) != length) { 

AfxMessageBox(_T(" 找み 込みに 失敗し ました"））； 
return; 



((CEdit*)GetDlgItem(IDC_TEXT))->SetWindowText(p); 
delete [] p; // 確保した メモリは 解放す る 
f .CloseO ; 

> 



メモリ リークの 瞬間 

ところで、 この 例では エラーの 修正は 稃 姑でした が、 エラー 行が わかった だけでは 修正 
が 難しい 場合 もあります 。たとえば ループの 中で new 演兑 子を 繰り返し 呼び出し ている 場 
六 や、 条件 分岐に よって new 演 灯 子が 実行され たりされ なかった りする 場合では、 どのよ 
うな 条件で new 演算子が 実行され たと きに メモリ リークが 発生す るの かを 突き 丨ト .めな けれ 
ばな りません。 このような ときに 便利な ユーティリティ _ 数が AfxSetAllocStop 丨 HI 数です。 



void AfxSetAllocStop(LONG IRequestN umber ) 

リ丨数 LONG IRequestNumber リクエスト 番号を 指定す る 



この間 数の 使い方は 簡舉 です 。この間 数は、 ほとんどの 方が 「何に 使う のだろう？」 と 思 
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われた はずの、 メモリ リーク メッセージの リクエスト 赉ひ（ tl の 問に 农氺 される 讲兮 です > 
を 使います 。于 •順と しては、 まず-度 アプリケーションを 灾行 して メモリ リークを 発/ 丨:. さ 
せ、 アウトプット ウインドウに 衣 示される リクエスト 潘 り •を 調べます 。次に メモリ リーク 
が 発 半 •している new 演兑了 •や malloc 閲数 などの 商 前に、， « ベた リクエスト 畨号 をリ丨 数に 
指定した AfxSetAllocStop 間数の 呼び出しを 神人し ます。 たとえば リクエスト 挢り 58 で 
メモリ リークが 発 叱 しているならば、 



AfxSetAllocSt 〇 D(58) ; 



というむ を 挿 人し ます。 ソースコードの 修丨丨 •: が 济 ん だら ビル ドし、 あらためて デバッガ か 
ら 起動し ます 。すると 指 走した リクエスト 挢リ •に 対応す る メモリの 確保が 行われた 瞬 問に、 
あたかも ブレーク ポイントを U つけた かの ように 火 行を 抄丨丨 •.して、 デバッガで 調 介を 丨別始 
できます。 これを 使えば、 メモリ リークが 発 1:. した 瞬 丨 の 変数の 侦や コール スタックを, 脚 
ベる ことができます。 

デバ ッグが 終わったら、 AfxSet AllocStop 閲 数を 穴む 行は 削って しまって 構いません 

スナップ シヨ ッ卜 

MFC による メモリ リークの 検出は アブリ ケー シ ョンが 終 r したと きに む われます 。アブ 
リ ケー シ ョンが 終 r する まではす ベての メモリが 参照され る "f 能 n: が あるので すから、 これ 
も肖然 のこと です。 しかし それだけでは メモリ リークの 発 Z|: 简 所を 特定す るの が闲 雉な 場 介 
もあります 。たとえば ループの 屮で メモリを 確保して いる 坳介 に、 2111111 以降で メモリ リー 
クが発 7 丨: •していたり、 特记の オプションを チェックして ダイアログ ボックスを 閉じた ときに 
だけ リークして いたり、 条件が そろった ときに だけ メモリ リークが 発/ ト: していても、 こうし 
た 条件は メッセージから 説み 取る ことは できません 。これを 補う 関数が AfxSetAllocStop 
間数だった わけです 。しかし この間 数は 完全に 冉现 竹: の ある 場 介に しか 役に立ちません。 災 
むする たびに、 メモリ リークを 発 中 する リクエスト 游り •が 変化す るよう な坳 介には、 リー 
クの 瞬間を 捕らえる ことは できない のです。 

先に アプリケーションが 終 广 する まで メモリ リークとは 判断で きないと 述べました が、 
それは ライブラリが 判断で きない だけで、 ブロ グラマに とっては そうではありません） プ 
ログ ラマは ソースコードを 説む ことで、 特定の エリアでは：^ 仝に new 演 灯/と delete 演 
兑 i の対必 が 閉じて いる ことを 判断で きます。 つまり new と delete が 閉 じている はずの、 
特 走の ソースコード 行の エリアを 設 定し 、この エリアに 人った ときの メモリ ブロックの 数 
と、 エリアを 出た ときの メモリ ブロックの 数を 調べて、 これが 一致して いなければ メモリ 
リークが 発 牛. している と 利 断で きる わけです。 このように、 ある 時办 での メモリの 状態 （ス 
ナッ ブ ショ ッ 卜） を とって メモリ リークを 検出す るた めの クラスが CMemoryState クラス 
です 〇 CMemoryState クラスの 中 •な メンバ 関数を 表 5-3 に 示します っ 
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メンバ 関数 


処理 


void CMemoryState::Checkpoint() 


スナップ ショットを とる 


BOOL CMemoryState::Difference 
(const CMemoryState& oldState, 
const CMemoryState& newState ); 


2 つの スナップ ショットから 差分を 作る 


void CMemoryState:: DumpStatistics() 


スナップ ショットの 内容を 表示す る 



表 5-3 CMemoryState クラスの メンバ 関数 



この 3 つの メンバ 閲 数は 次のように 組み 介 わせて 使います。 

CMemoryState begin, end, diff; 

begin • CheckDointo ();// この 時点での メモリの 確保 状況の スナップ ショットを begin にと る 



// この 範囲では new と delete の 関係は 閉じて いるもの とする 



end • Checkpoint () ;// この 時点での スナップ ショットを end にと る 
if (dif f . Difference . (begin, end)) { 

//CMemoryState::Difference は begin と end の莲 分が 空で なければ TRUE を 返す 
diff .DumpStatisticsO; // 莲 分を 表示す る 

> 

このような コードを 塊め 込んで おけば、 メモリ リークが 発生す ると CMemoryState::Dump 
Statistics メンバ 間数に よって 差分の 状況が 次のように アウト ブット ウィンドウに 出力され 
ます。 これに よって、 いくつの メモリ ブロックが リークし ている のか、 そして その サイズ 
は どれほど であるの かを 知る ことができます。 



0 bytes in 0 Free Blocks- 

1100 bytes in 1 Normal Blocks • 

0 bytes in 0 CRT Blocks. 

0 bytes in 0 Ignore Blocks . 

0 bytes in 0 Client Blocks. 

Largest number used: 1054 bytes. 

Total allocations: 1399 bytes. 

この 例では Normal Block が 1 つ リークし ており、 その サイズは 1100 である ことを 意味 
しています。 

差分は 5 神: 類の ブロック 夕 イブに 分類され て レ ボート されます 。それぞれの ブロック タ 
イブの 意味は 表 5-4 に 示す とおりです 0 

表 5-4 の 中で- Free Blocks」 だけが 異彩を 放って います 。なぜなら ここに レポートされ 
る メモリ ブロックは 「解放され ていない ブロック」 なのです から、 荇 通なら ば 「Free Blocks 
(解放 済み ブロック）」 が リストアップ される はずは ないから です。 それでも ここに そのよう 
な顶 II が 用意され ている のは、 MFC に 解放した メモリ ブロックを 保存して おく 機能が ある 
からです 。ただし この 機能は デフ オルトでは 無効に なって います。 この 機能を 有効に する 
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ブロック タイプ 


目的 


hree Blocks 

— ■ ■ ■ — ^ 


解放され た メモリ ブロック （後述） 

■ — 


Normal Blocks 


char や int といった 基本 型 や CObject クラスを 継承して いない クラスの ために 

確保され た メモリ ブロック 




CRT Blocks 


C ランタイム ライブラリ 内で 確保され た メモリ ブロック 


Ignore Blocks 

一国 ^ 


メモリ リーク 検出 機構を オフに している ときに 確保され た メモリ ブロック 


Client Blocks 


CObject クラス および その 派生 クラスの オブジ ヱ ク卜 のために 確保され た メモ 
リブ ロック 



表 5-4 ブロック タイプ 



ためには、 MFC 内部で 定 在され ている グロ一バル 変数 a fxMemDF に delayFreeMemDF 
を設记 する 必要が あります 〇 M •体 的には 次の ような コードが 突 行され た 行 以降から、 機能 
する ようになります 。論 •和で 代人して いるのは、 a fxVlemI)F には その他の メモリ 竹 内 UIJ 
フラグ も 設定され ている からです 。 

afxMemDF |= delayFreeMemDF; 

この 憷 能を 利 川す ると、 delete 演灯 r や freelKJ 数に よって メモリを 解放しても、 その メ 
モリ ブロックは 洱利⑴ されなくなります 0 つま 丨） 解放した ときの データが そのまま メモリ 
に 残る ため、 割り、 1 彳 てられて いた メモリの 内界の チェックが iif 能になります 。ただし、 その 
副 作 川と して システムが メモリ 小足 状態に なりやすくな ります。 通常 解放され た メモリは 
次の メモリ 確保 要求に よって 办利 用され ますが、 これが まったく 行われなくなる ため、 し 
ばらく すると メモ リイく 记状 態になる わけです 。これを 利 州 して、 总丨ズ | 的に メモリに スト レ 
スを かける テストに; H いる こと もで きます。 

春 診断 関数 

デバッガ にしろ、 メモリ リーク 検出 機能に しろ、 ここまでの デバッグ 技法は すべて、 バ 
グ が発觉 してからの 対処に 使う ものでした 。確かに デバッグは バグが 発 党して から 行う も 
のです が、 あらかじめ バグが 発觉 したと きに 備えて おく こと も 町 能です。 

1 つは 要所 紫 所に 案 行 時の 正玛 性を 確かめる チェック ポイントを 設けて おく 方法です。 た 
とえば メモリ アクセスに 失敗して プログラムが 與 •常 終了す るのを 待つ よりは、 ポインタの 
計 灯が 济 んだ畤 点で ポインタが 指し/ す メモリに 期待 どおりの データが 存在して いるの か 
を チェック すれば、 ポインタの •汁 灯 に 問題が ある ことが たちどころに わかります。 

診断の タイミング としては 、関数が 呼び出された 贞後 などが 考えられます。 たとえば 列 
舉叩 • （enum) の 侦を受 け 取る 丨妇 数では、 列挙 ゆ •で 定義され た 整数# I: の範 | 用 だけが 正当な 侦 
となります。 これを if 文で チェック する こと もで きます が、 正しく 丧 かれた コードな らば、 
範丨用 外の 侦が 渡される ことは ない はずです 0 これを if 文で 悔度 チェックす るのは 時冏の 組 
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駄 という ものです。 それなら ば デバッグ 说垃 でのみ •摩 断 コードが％ 行され るよう にして お 
くの が 得策です。 

もう 1 つは オブジェクトの ダンプを 界砧 にす る" 法です： printf 义 などに よる 変数の 倘 
の 出力は 的中 •に 行える ことから、 よく 川 いられる デバッグ 技法です が、 クラス や偁造 体の 
オブジェクトに 問して はそう もい きません。 すべての メンバ 変数を 説み やすい 形で 出力 さ 
せる ためには H 行 もの コードが 必 災: です， さらに メンバ 変数が 変 01 になって 、梢 減したり、 
耶が 変わったり 、介 効な 侦の範 叫が 変わった 丨） という ことは ブロ グラムの 開発 屮に 頻繁に 
起こる ことです > これに 対丨え: して ダンプ コードを 変 1 ii して まわる 作 袋は 人 変な 労 乃 が必 贤 
です， そこで MFC には オブジェクトを ( KPiU こ テキスト 形式で 出力す るた めの 挖# 的な" 
法が 川总 されて います。 

以 ドでは この 2 点に ついて 解説し ます。 

式の 診断 （ ASSERT マクロ、 VERIFY マクロ） 

もっとも 袼本 的な •珍 断 マクロが ASSERT マクロです この 閲 数は C I 丨 •，沿の assert 間 
数に よく 似て いますが、 デバッグ 说垃 でのみ 機能す ると ころが 迠 います c つまり Win 32 
Debug プロジェクト 構成で 记 •没され ている — DEBUG マクロがなければ ASSERT マクロは 
卞に记 在され るので、 その 行は コンパイルされ ません。 いちいち ASSERT マクロを # ifdef 
〜# endif でく くったり、 削って 丨" 丨っ たりし なくても、 リリース” には ASSERT マクロに 
丨阳违 する 余分な コード サイズ や処 fl ! 時丨丨 IJ を 竹く ことができます。 

ASSERT マクロの Wi いみは 次のと おりです。 



ASSERT(BOOL expression ) 

リ I 数 BOOL expression il : しく# 作して いる 131 り i _ (•となる 灸 f | ••八を 指) じする 

たとえば 以 ドの ような ASSERT マクロが あった とします， 

ASSERT (p != NULL) 

これは ブロ グラマに よる 「この 位 丨7 (で p が NULL になる ことは ありえない」 という 丨:.张 
です。 もし p が NULL であれば、 つまり ASSERT マクロの リ丨 数に 指) U した 式が 成り、 X た 
なかった 坳六 、図 5-17 にボ すよう な ダイアログ ボックスが 衣尔 されます 3 ここには く屮 
丨1.>、 <队武 行 >、 < 無 拟> の 3 つの ボタンが# •ん でい ます。 <|丨|丨丨-.>ボ タンを クリック 
すれば、 ブロ グラムの 火 行が 終 T されます < 外 •式 行 > ボタンを クリック すると、 デバ ッ 
ガ が起勋 され、 アサ ーシ ヨンに' 人 •敗した 筒 所から デバッグを 開始で きます 。 <無视>ボ 夕 
ンを クリック すると、 ASSERT マクロの 次の 行から 火む を 絞け ます。 

ASSERT マクロは MFC の 内部で たくさん 使われて いるので、 H 分の ソースコードに 1 
つも 記 述 していなくても アサ ーシ ヨンに' 人 •敗して プログラムが 終 r する ことがあります。 こ 
の 場 •介、 アサ ーシ ヨンに 欠 •敗した 聞 数を 呼び出す TV 丨 ij •に なんらかの バグが あった と芩 えら 
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For information on how yotr procram can cause an assertion 
failure, see the Visual documentation ot 



(Press Retry to debut the application) 



r~yiBgn (& J mm J 



図 5-1 7 Assertion Failed 

れ ます。 ASSERT マクロは I: •に閲 数が 呼び 川 され たれ 後に、 リ丨 数が 正当な もので あるかを 
チェック する II 的で 使われる ため、 丨丨: しく 引数を 渡して いるかを 確かめる とよいで しょう。 

ところで ASSERT マクロを 使う ときには expression に 副 作 川の ある 式を 記述して はい 
けません。 なぜなら ASSERT マクロは デバッグ 環境 だけで しか 機能 しないので、 リリー 
ス说 境と デバッグ 说 境で プログラムの# 作が 変わって しまう からです。 たとえば 次の よう 
な 式を 指定す ると、 リリース 環境と デバッグ 環境では i の侦が W •なって きます。 

ASSERT (i++ != 0) 

どうしても このような 指定が したければ、 ASSERT マクロの 兄弟 マクロで ある VEK 
IFY マクロを 使います 。この マクロは リリース 環境で も デバッグ 環境で も 式の 評価を 行う 
ASSERT マクロと 名 •えられます 。ただい； リース 说垃 では 式の 侦が i •(•であるか どうかの 
チェックは 行われません。 八 SSEKT マクロと VERIFY マクロに よる マクロ 展開 後の 違い 
は 表 5-5 に 示す とおりです。 





ASSERT(i++ != 0) 


VERIFY(i++ != 0) 


デバッグ M 境 

— J 


assert(i++ != 0) 


assert(i++ != 0) 


リリース 環境 


なし 


j i++ != 0 



表 5-5 ASSERT マクロと VERIFY マクロの 違い 



クラス 才 フジ I ク 卜の 診断 （ CObject::AssertValid メンバ 関数） 

ASSERT マクロは 中. 純な 式の 評価には 便利な マクロで すが、 複雑な 式を 評価す る坳 合に 
はいくつ もの 式を && で 結んだり する ことにより、 ソースコードが わかりにくく なること 
があります 。とくに クラス 才 ブジェク 卜の 診断を したければ、 すべての メンバ 変数に 間し 
ての 診断を しなければ なりません し、 ASSERT マクロを 使った 診断 叫の コードを 何 か 所に 
も 埋め込む のは 小 経済です 。それに メンバ 変数は private か protected である 場合が 多い 
ので、 こうした 場合には クラスの 外から メンバ 変数に 対して 診断を 行う ことは できません。 
そこで MFC には クラスの オブジェクト 古: ⑴ バージョンの ASSERT マクロ、 ASSERT 
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VALID マクロが 用? $ されて います。 ASSERT_VALID マクロを 使う と、 クラス 才 ブジェ 
クト への ポインタを 渡す とその オブジェクト について 診断を 行い、 問題が あれば ASSERT 
マクロと 丨》1 じように ダイアログ ボックスを 衣 示して アサ ーシ ヨンの 失收を レポート する こ 
とがで きます 。そのし くみは、 丨 1 的の クラスに AssertValid メンバ 問 数を 灾 装して おき、 
ASSERT_VALID マクロに よって これを 呼び出す という ものです 。ただし AssertValid メ 
ンバ閲 数は CObject クラスの 仮想 メンバ 閲数 として 呼び出される ため、 I 丨 的の クラスは 
CObject クラスの 派 屯 クラスで ある 必要が あります 0 
CObject::AssertValid メンバ 閲 数の プロトタイプ 穴《1 •は 次のと おりです 。これにし たがつ 
て オーバーライドし、 その 中で ASSERT マクロな どを 使って 診断を 行います。 

virtual void CObject::AssertValid( ) const; 



たとえば、 CFile* 喂 メンバ 変数 f と UINT 喂 メンバ 変数 len を 持つ CAssertTest クラス 
が 次のように 记義 されて いると します 。ここでの ポイントは CObject クラスの 派 卞. クラス 
である こと、 もう 1 つは AssertValid メンバ 問 数の 记義 を# ifdef _DEBUG〜#endif で W 
むこと です。 CObject::AssertValid メンバ 問 数は 他の デバッグ 閲数胙 と 1"1 じく _DEBUG マ 
クロが 走 衣され ている ときの み 定義され るので、 この 処阶 は必姒 です 0 

class CAssertTest : public CObject //CObject クラスの 直接、 

// または 問 接 派生 クラスを 作る 

{ 

protected: 

CFile* f; 

UINT len; 
public : 

#ifdef .DEBUG 

//AssertValid メンバ 間数は デ バック 田 境での み定 8 される ので、 

//#ifdef で 囲む 必要が ある 

virtual void AssertValidO const ; 

#endif 

>； 



このと きの CAssertTest:: Assert Valid メンバ 問 数の 火 装 例は 次のようになります 。ここ 
での ポイントは、 从嵌 クラスで ある CObject クラスの AssertValid メンバ 問 数を 呼び 川 
している ところです 〇 CObjectrAssert Valid メンバ 関数には CObject クラスに 対する 診断 
コードが ある わけです が、 CAssertTest クラスに よって オーバーライド されて しまう とこ 
れが 機能し なくなって しまいます。 そこで 明ボ 的に 袼眹 クラスの メンバ 問 数を 呼び出して 
いるので す 。次に CAssertT eS t クラスの メンバ 変数の 診断を 行います 。まず CFile*® 才 
ブジェク ト f です が、 CFile クラスには MFC によって AssertValid メンバ 関数が 火 装され 
ている ので、 ASSERT_VALII) マクロを 使って 診断を 依赖 する ことができます。 このよう 
に 各 クラス ごとに 診断 コードを 川 立して おく ことで、 丨 つの クラスで すべての 診断を 行う 





必欢 がなくなります 。なお MFC で 走 尨され ている クラスの ほとんどには Assert Valid メ 
ンバ閲 数が 火災: されて います （ただし CObject クラスの 派 , I: •クラスに 陨 る）。 般 後に 椹 外: 
削 UINT の メンバ 変数 丨 en に ASSERT マクロを 使って 診断は 終わりです c 

#ifdef _DEBUG // 間数の 実装 全体を # ifdef 〜 #endif で 固む 
void CAssertTest: :AssertValid() const 
{ 

CObject : : AssertValidO ; 

// 基底 クラスで ある CObject クラスの AssertValid メンバ 間数を 呼び出す 
if (f != NULL) { 

ASSERT. VALID(f); 

//CRIe クラス オブジェクト f を胗 断す るた めに 
//CFile::AssertValid メンバ 間数を 呼び出す 
ASSERT(f->GetLength() == len) ; 

// 才ブジ 王ク卜 f が 指す ファイルの 長さと 
// メンバ 変数 len の 値が 同じで ある ことを 確かめる 
> 

> 

#endif 

こうして 火 装が 済んだら、 次のょうに ASSERT-VALID マクロを 使って CAssertTest 
クラス 才 フジェ ク 卜の, 滚 断が iif 能になります。 すると cAssertTest::AssertVa 丨 id メンバ 丨对 
数が 火 行され、 そこに f? まれる すべての# 断を 通過した とき だけ、 CAssertTest クラスの 
診断が 成功に 終わります。 

CAssertTest* p = new CAssertTest; 

ASSERT.VALID(p); 

C〇bject::Dump メンバ 関数 

printf 閲 数 や cout を 使っ て デバ ッグ メッセージを 川 力させる のは I 丨 ••から 行われて いるデ 
バ ッグ f-iJ: •です が、 クラス 才 ブジェク 卜 令 体を デバッグ メッセージ として 丨丨丨 力 させょうと 
すれば、 人 変な 作 袋です。 け/} としては A ssert V a iid メンバ 丨对 数と 丨"丨 じょうな ものです 
そこで MFC には クラス 才 ブジェク 卜を すべて 人間が 説め る肜 にして 出力す る檔 •的な ノ ゾ 
法 か 提供され ています。 それが CObject::Dump メンバ 閲 数です 
CObject :: I)ump メンバ | 服/の プロ 卜 タイプ 穴 •は 次のと おりです c〇b j ec d 
メンバ 閲数と M じく CObject クラスの 想 メンバ 閲 数と して 災 在され ています したが っ 
て Dump メンバ 閲 数を 使うた めには、 || 的の クラスを c〇b j ect クラスの 派 斗: クラスと す 
る 必要が あります a 

virtual void CObject::Dump(CDumpContext& dc) const; 

引数に とる CDumpC'ontext クラスは CArchive クラスに 似た クラスです （評しく は 第 3 
部を 参照の こと） 。つまり CDumpContext オブジェクト である dc を 使えば 




int a; 

char b[] = "debug message: ; 

dc « b « a; 

のように <<演 灯 了 •を 使って デバッグ メッセージを 出力す る ことができます 。出力 先は 通 
常、 アウト ブット ウインドウの デバッグ タブです。 

前 節での CAssertTest クラスと M じように、 CDumpTest クラスを 次のように 定義し 
て、 Dump メンバ 関数の 灾装 例を, j; •します。 クラス 走 在での ポイントは A ssertVa 丨丨 d メン 
バ 数と まったく M じです。 繰り返しになります が、 CObject クラスの 派 屯 クラスで ある 
こと、# ifdef _DEBUG〜#endif で Dump メンバ 関数の ブロ トタ イブ 饩 •丨 •を | 用む のを 忘れ 
ないように してく ださい。 

class CDumpTest : public CObject //CObject クラスの 直接、 

"または 間接 派生 クラスを 作る 

{ 

protected: 

CFile* f; 

UINT len; 
public : 

• • • • 

#ifdef .DEBUG 

"Dump メンバ 間数は デバッグ OS 境での み 定義され るので、 

#ifdef で 囲む 必要が ある 

virtual void Dump (CDumpCont ext & dc) const 
#endif 

}； 

このと きの CI)umpTest::I)ump メンバ 閲 数の 龙裝は 次のと おりです 。ここで も 構造は 
AssertValid メンバ 閲数 とよく 似て います 。まず CObject::Dump メンバ 関数を 明示的に 呼 
び 出します 〇 II 的は CObject クラスを ダンプす る ことです 。次に CFile クラスへの ボ イン 
夕を dc に 出力して います 。これに よって CFile::Dump メンバ 関数が 呼び出され、 CFile ク 
ラス 才 ブジェク 卜が ダンプされ ます。 以後に UINT 增 メンバ 変数 len を 出力し ます 。これ 
で CDumpTest クラスの メンバ 変数 すべてを ダンプす る 中: 備が幣 いました。 



#ifdef .DEBUG 

void CDumpTest : :Dump(CDumpContext& dc) const 

{ 

CObject :: Dump (dc) ; 
dc « f; 

dc << "file length: ，•<< len; 



#endif 
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Dump メンバ 間数の 突 装が •済んだら、 プログラム 中の どこから でも 次の コードを 咨き込 
むこと で クラスを まるごと ダンプす る ことができます 0 

CDumpTest* p = new CDumpTest; 

#ifdef .DEBUG 
afxDump << p; 

#endif 

afxDump は MFC の 内部で 定義され ている CDumpContext オブジェクトです。 ただし 
デバッグ 環堍 でのみ 记 在され ている ので、# ifdef で丨 用む ことを 忘れずに 0 

以丨 •.で Visual C + + での デバッグ f •法の 解 I 兑を 終わります， Visual C + + には デバッガ、 
ライブラリの 丨叫 If 丨丨 から さまざまな デバッグに 便利な 機能が 提供され ています が、 f 云統 的に 
使われて いる デバッグ f •法 も 忘れない ようにして ください。 もっとも 効 Jli の ある デバッグ 
f •法は、 「関係の ない コードを 削った、 コンパクトな プログラムを 作る こと」 です 。まずは 
プログラムの 勋作に 支阳 をき たさない 萜丨 用で ソースコードを 削り、 怍 しい简 所を 狄め てい 
くこと です 。また 4 能な 限り クラス ごとに 小さな# 作 チェック） 丨丨 ブロ グラムを 作って おく 
とよいで しょう。 



第 



3 



部 



MFC を 使って みよう 



第 1 部では Developer Studio 、 AppWizard 、 リ ソー 
スエ デ ィタ、 ClassWizard などを 利用した プログラム 
作成の 手順と MFC を 使った プログラムの 基本的な 祸 
造に ついて 説明し ました。 第 2 部では、 グラフィックの 
表示 や ダイア □グ ボックス などを 使って、 実際に MFC 
を 使っ た Visual C + + プログラミングに® 串に 触れて 
みました。 さて、 ここから が 本番です。 第 3 部では い 
よいよ フレームワーク としての MFC の 機能を 使って、 
少 々本格的な プログラム 作成に 挑戦して みます。 さま 
ざまな 要 索が 複雜に 絡み合いながら プ □グラムが 構築 
されて いきます から、 クラスの 構造 やオ ブジェク 卜の 
相互関係に 注 S し、 コードの 流れを 把握す る ことが 大 
切になります。 




テキス 卜 エディタを 
作って みよう 



第 3 部で 作成す る プログラムは、 2 神铂の データ、 すなわち テキスト データと M 形の 描丨由 i 
デ 一夕を 扱います。 つまり、 テキスト エディ 夕 + ドロー ツールと いう惝 成の プログラムを 
作る ことが 第 3 部の 丨丨標 です 。まず、 Ai 初に MFC に川总 されて いる 便利な クラスを 使つ 
て、 テキスト エディタを 作成す る ことにします 。しかし、 その 前に 第 1 部で 芯 「•の 説明を し 
た ドキュメントと ビューに ついて、 もう 一度 簡中 •にお さらいして おき ましょう 。なぜなら、 
ここからは ドキュメントと ビューと いう MFC を 支える 2 つの 装な クラスを 利用して ブ 
ログ ラムを 構築して いくから です 。ドキュメントと ビューの 閱係 についての 説明が 終わつ 
たら、 プロジェクト 个 休の, •をして、 次に テキス 卜 エディタの 作成に 取り かかります。 

1.1 残して こそ 意味の ある ドキュメント 

Visual C + + でい う ドキュメントとは 、アプリケーションが 扱う データ 全般を 指す 言 集- 
です 。たとえば、 A という アブリ ケー シ ョンは テキスト という ドキュメントを 扱い、 B と 
いう アプリケーションは ドロー データと いう ドキュメントを 扱う、 というよ うに 各 アブリ 
ケー シ ョンには それぞれ 扱うべき ドキュメントの 神: 頌が あります 0 これを 本 •丨 では ドキュ 
メン卜 タイプと 呼びます。 このように 一般的に 使われる ドキュメント という 言焰 よりも 広 
い 立 味を 持たせて いる ことに fi :. 立して ください。 また ビューとは、 ューザーと アブリ ケー 
シ ョンとの 問 の インターフェイスを 指す， 丨 •您 です 。つまり、 ユーザーが アプリケーション 
に対して 指/〗 i を 出 す" 法と、 アプリケーションが ューザー に対して 悄 報を ポす 方法を 介 わ 
せて ビューと 呼びます。 そして Visual C + + と MFC を 使う ときには、 この ドキュメント 
と ビューを 明確に 分離して プログラミング する ことが 要求され ると いう ことを 第 1 部では 
述べました。 

ところが 第 1 部で 触れて 以来、 ドキュメント や ビューには とくに 注盘 をはら わずに 済ま 
せて きました 。しかし 第 3 部では ビュー だけでなく ドキュメントの 灾焚も 行います。 簡ネ 




にいって しまえば 、「アプリケーションが 作成した データを ファイルに 保存す る 方法を 示 
す」 という ことです： いよいよ MFC に 川 这 された フレームワーク としての 機能が 本領を 
発柯し 始めます。 

•ドキ ュメ ン 卜と ビュー 

Visual C+ + では、 ドキュメントと ビューと いう 概念を 川いた プログラミング スタイル 
を 指して、 ドキュメント 一 ビュー •アーキテクチャと 呼んで います 〇 それでは 火 際に ドキュ 
メン 卜-ビュー .アーキテクチャを 川いて プログラムを 作成す るた めには、 どういった コー 
ドを 記述 すれば よいので しょう？ 

ドキュメントと ビューを それぞれ 別々 の クラスを 使って 火災 するとい うのが、 ド キュメ 
ン ト- ビュー •アーキテクチャの 从水 姿勢 だとい うのは 第 1 部で もお诂 しした とおりです。 

まず、 ドキュメント クラスと して CI)oci 丨 nient クラスの 派 少 クラスが 必欢 です。 派少ク 
ラスを 作る わけです から、 ドキュメントを 竹观 する ために 必货な 機能は CDocument クラ 
スが 提供して くれます， したがって、 派 叱 クラスには 、ドキュメントを 保む: する ための 変数 
を； n 加したり、 边 加した メンバ 変数を 挽 作す る メンバ 叫纹を 追加す る だけで、 ドキ ュメン 
トクラス として 必贤な 機能は 川 立 できます 3 プログラマが 記述し なければ ならない これら 
の メンバ 問 数の 中で もっとも ホ: 要な のが Serialize 間数です 。この 関数は メモリ 丨 •.の ドキュ 
メント を ファイルに 保む: したり、 ファイル 丨 •.の ドキュメントを メモリに 说み 込んだり、 ド 
キ ュメン トクラスの 中心と なる 問 数です 

また、 ビュー クラスと して、 CView •クラスの 派 卞 クラス も必 •松です。 ビュー クラスは す 
でに 何度も 扱って いますから、 その勋 作は よく わかって いる ことと 恐い ますが、 マウス や 
キーボードを 使った ューザーからの 人力を 受け取った 〇、 ウィンドウに 文字 や阅 形を 衣 示す 
るのに 使います 。しかし、 ドキュメントを 扱い はじめる とそれ に加えて、 ユーザーの ビュー 
への 操作を ドキュメントに レ; 映しなければ なりません し、 ドキュメントの 内衫が 変 史 され 
たら、 それを ウィンドウ などに 反映し なければ なりません 。このような 処坪 をむ うには、 ド 
キ ュメ ン トクラスとの 迚携 プレイが (•及: になって きます 〇 今までの ように ューザーの 报作 
を すぐさま ウインドウに 反映させる のでは なく、 •度 ビュー クラスから ドキュメント クラ 
スに ユーザーの 操作を U •え、 ドキュメントに 変 史 を; 川え てから、 改めて 変 セされ た ドキュ 
メン 卜の 丨人 rff を ウインドウ などに) 义映 させる、 といった 処坪 をむ うこと も必贤 になって き 
ます。 



アクセス 元 


取得す る オブジェクト 


メンバ 関数 


ドキュメント クラス 


ビュー クラスの オブジェクト 


GetFirstViewPosition/GetNextView 


ビュー クラス 


ドキュメント クラスの 才 ブジェク 卜 


GetDocument 



表 i - i 他方の クラスの オブジェ ク 卜を 取得す る メンバ 関数 






1.2 プ ロジェ ク 卜の 設計 



このように ビュー クラスと ドキュメント クラスは 別々 の クラスでは あっても、 密接に かか 
わって いるた め、/ 丨 •.いの メンバに アクセス する ことが よくあります 。そこで、 CDocument 
クラスと CView クラスには 他ん •の クラスの オブジェクトを 取以 する ための メンバ 閲 数が 
⑴ 立され ています （表 1-1)。 これらの 関数を 使えば、 他" の クラスの パブリックな メンバ 
に アクセスで きます。 

1.2 プロ ジエク 卜の 設計 

第 3 部で 作成す るのは、 テキスト エディタ + ドロー ツールで すが、 まずは おおざっぱに 
プログラムの 偁成 をっ かむ ために、 その 个体 的な 梆 成を ぢ •えてみ ましょう。 第 1 部で も述 
ベました 力、 1 つの ドキュメント タイプに つき、 1 つの ドキュメント クラスと ビュー クラス 
が必 •松な ことを 党え ている でしよう か （リソースと フレーム ウインドウ も必贤 だが ここで 
は 2 つの クラスに ilill する〉。 ここでは 2 つの ドキュメント タイプを 扱う のです から、 2 組 
の ドキュメントと ビューが 必要になります （図 1-1 K 
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図 1-1 主要 クラスの 関係 図 
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1 テキス 卜 エディ 夕を 作って みよ 5 



それぞれの ドキュメント タイプは 独立して 作る ことができ るので、 まず 本^ で テキスト 
エデ ィタを 作りながら、 ドキュメント 一 ビュー •アーキテクチャを 利) II した アブリ ケー ショ 
ンの 基本的な 構成に ついて 説明し ます。 また、 ドキュメント 一 ビュー •アーキテクチャと 並 
ぶ MFC のもう 1 つの 朴: である シリアライズに ついても 説明し ます。 2 なでは、 ドロー ツー 
ルを 作成しながら、 複数の ドキュメント タイプを 扱 うん •法、 ドキュメントの シリアライズ 
の 突 際、 MFC の ポリシーに 乘っ 取った クラスの 此丨丨 •について 説明し ます。 

それでは、 テキスト エディタ + ドロー ツール = マルチメディア ビュー アの プ こ 成丨 义丨 を 横 || 
に M つつ、 作 菜を 始める ことにしましょう （図 1-2)。 




図 1-2 完成した アプリケーションの 画面 



1 .3 最初の 一歩は AppWizard から 

何は ともあれ、 プログラムの スケルトンを 作成す る ことにし ましょう。 メニューから 
[フ ァイ ル]— [新規 作成]- [プロジェクト ワーク スペース] を 選択し、 プロジェクト 名に 
「MMView」 （Multimedia Viewer の 略） と 人力して ください。 <〇K > ボタンを クリック 
したら AppWizard が 起動す るので、 それにしたがって 設 走 拟丨| をい く っか設 泡し ます。 

•ステップ 1 

ここでは [作成す る ァプリケーションの 神 類] で [MDI] を 選択し ます 0 神: 類の 與 なる 
複数の ドキュメントを 1 つの ウィンドウに 表示す るには、 MDI を 利用す るの が 簡単で 



1 .3 最初の 一歩は AppWizard から 



す 〇 MMView では 2 棟 類の ドキュメント タイプを 扱います から、 MDI を 利用し ます 0 
ただし、 AppWizard は 1 組の ドキュメント クラスと ビュー クラスし か 生成して くれ 
ない ので、 とりあえず テキスト エディタ のために AppWizard が 生成した クラスを 使 
うこと にし ましよう 。もう 1 つの ドキュメント タイプを 扱うた めの クラスは、 あとで 

Class Wizard を 使って 作ります。 

•ステップ 2 

ここでは アプリケーションに データベースへの アクセス 機能を 付加す る 設定を 行う 
ことができ ますが、 MM View には 必要ない ので [データベースの サボー 卜] に [しな 
い] を 選択し ます 。なお デ 一夕 ベースの サポートを 利 爪す ると、 ODBC や DAO を 
いた デ 一夕 ベースへの アクセスを 行う 基本的な コードが AppWizard によって スケル 
トンに 追加され ます 〇 MFC には データベースを 利用す る アプリケーションの ために、 
CRecord View クラス や CRecordset クラスな どが 用意され ています。 

•ステップ 3 

ここでは OLE 対応 アブリ ケー シ ョンを 作成す るた めの 設定を 行う ことができ ますが、 
やはり MMView には 必要ない ので、 [どの 複合 ドキュメントを サポート します か？] に 
は [しない] を 選択し ます 。また [その他 どの サボー 卜を します か？] についても チェ ッ 
ク をはず して おきます 。なお OLE 対応 アプリケーションは、 複数の アブリ ケー ショ 
ンが あたかも 1 つの アプリケーションで あるかの ように 速携 して 機能す る ことができ 
ます。 

•ステップ 4 

ここでは その他 もろもろの 設定を 行います。 まず [アプリケーションへ 組み込む 機能] 
には、 初期 状態の まま、 [ドッキング ッール バー]、 [初期 ステータス バー]、 [印刷 お 
よび 印刷 プレビュー]、 [3D コントロール] の 4 つに チェックを 付けて ください。 
[MAPI (メッセージ API)] と [Windows ソケット] の チェックは 2 つと もは ずして お 

きます 。これらは メールの 送受信 や インターネットへの アクセスを 行う アブリ ケー ショ 
ンを 作成 するとき に 利用す る 機能です。 

[敁 新フ ァイ ルの 一 览 に 表示す る ファイルの 数] は、 [ファイル] メニューに 敁近才 一 
プン した ファイルの-泣を 表示 するとき に、 似 •人い くつまで ファイルを 並べる かを 決 
める ものです 0 
♦ステップ 5 

[ソー スフ ァイ ルの コメントを 生成し ます か？] は 作成す る EXE ファイルには 直接 影 
興しません 。ただ、 AppWizard や ClassWizard が 生成す る コードに 動的に コメン 
トが迨 加され る だけです 〇 2 つの Wizard が 生成して くれる コードは 便利で ある 半面 
理解せ ずに 利用して しまいが ちです。 惯れ ない うちは コメントを 付けて おくと よいで 
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1 テキス 卜 エディタを 作って みよう 



また、 Professional Edition 以上の Visual C++ 6.0 を 使用して いる 場合は、 ここで リ 
ンク する MFC ライブラリの 棟 類を 指定で きます （Standard Edition の 場合は、 リン 
ク できる のは 共有 DLL だけな ので、 App Wizard には この 表示は ない ことに 注意）。 
[MFC ライブラリとの リンク] は [MFC の 共有 DLL を使丨 II] に チェックを 付けて くだ 
さい 。共有 DLL を 使う と EXE ファイルの サイズを 小さく 抑える ことができ ますが、 
別途 MFC42.DLL 等の DLL ファイルを) H 总 しなければ 動作し ない EXE ファイル にな 
ります （通常 「Windows¥System」 フォルダに 川总 される） 0 Visual C + + には もちろ 
ん 必要な DLL が 添付され ている ので 問題ありません が、 他の マシン 上で も 動かした け 
れ ば、 DLL も M 時に 持って いかなければ ならない かもしれ ません。 jt •有 DLL の 代わ 
りに スタ テ ィッ クライブ ラリを 使う と、 EXE ファイルの サイズは 人き くなります が、 
DLL を 必要と しません 。この Jfill は スケルトンの 生成 後 も変史 が nj* 能です から、 通常 
は 共れ DLL を 使用と して おけば よいでしょう。 

春 ステップ 6 

W: 後に AppWizard が 牛 •成す る クラスと ファイルの 名前を 設定し ます。 AppWizard 

は プロジェクト 名を もとにして デフ ォルトの クラス 名 や ファイル 名を 決めます が、 
MMView のように 複数の ドキュメントを 扱う アブリ ケー シ ヨンでは それぞれの クラ 
スが 米 •たす 役沏に そぐ わない 名前に なって しまいます 。ここでは 表 1 -2 のように クラ 
ス 名を 変 1 ii します 〇 M 時に、 これらの クラスの 灾装 ファイルの ファイル 名 も 変 史 して 
おいてく ださい （図 1-3) 0 
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CTextEditDoc 


MMViewDoc.cpp 


TextEditDoc.cpp 


ビュー クラス 


CMMViewView 


CTextEditView 


MMViewView.cpp 


1 extEditView.cpp 



表 1-2 [クラス] ダイアログ ボックスでの 変更 部分 
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図 1-3 クラス 名と ファイル 名の 変更 







1.4 たったの 4 行で テキス 卜 エディタの できあがり 
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以丨 •.の 操作が 終わったら 、く 終 r > ボタン、 続けて < ok > ボタンを クリックして スケル 
トンを 牛. 成して ください 。スケルトンが 作成され たら、 次は ドキュメント クラスと ビュー 
クラスの 実装に 取り かかる ことにし ましょう。 

1.4 たったの 4 行で テキス 卜 エディタの できあがり 

テキスト エディタには どんな 機能が 必要で しょう か？ とにかく 、ファイルの 読み 枰 き、 
テキストの Mi 人 削除が できる ことは 絶対 条件です し、 1 丨 由 iifti に 収まらない テキストなら 
ば、 スクロール バーを 使って スクロールさせる こと も 必要です 。それから、 クリップ ボー 
ドを 使った 処现 や文卞 列の 検束 v K 換な どもで きれば 便利です 。さらに、 こうした 処理を 
行うた めには、 いくっもの ダイアログ ボックス や メニューを パ] 立す る 必要 もあります 。こ 
れ だけの 処那を 行うた めには 膨 人な l _ i : の コードが 必要になる ことは 想像に 難くありません。 
なにしろ 簡中 •に テキストの 揷人 といっても、 キーボードからの 人力/メモリ 竹理 / 文字 •列 
の 表示な ど 必要な 処邱 はいくら でもあります。 

少 々イヾ 安に なって きた かもしれ ません が、 もちろん 丨1 述 した 処现 をす ベて 1 から 紀 述す 
るよう な i •(•似は しません 。たとえば 、エディット コントロールを 使えば、 テキストの 褊染は 
ほとんど コントロール 内で 処 する ことができます 。また、 AppWizard が 生成した コード 
を コンパイルして みれば わかる ように、 すでに メニュー や ファイル オーブン ダイアログな 
どは 川总 されて います 。しなければ ならない のは コントロール や フレームワークの サービ 
スを うまく 結び付けて、 テキスト エディタ として 勅 作させる こと だけな のです 。小 安を 取 
り 除く ために 先に 述べて おきます が 、 App Wizard が 4: 成した コードに たった 4 行の コード 
を 付け加える だけで、 テキスト エディ 夕は 完成です 。あとは リソースを 少 々押き 換える だ 
けです。 しかも、 MDI を 利 叩して いるので、 マルチ バッファ マルチ ウィンドウを サボー 
ト した、 マルチ ファイル テキスト エディ 夕が あっとい うまに できあがります 0 
z メ (の V •い, 说荇 のために、 先に 変! U 简所を 兄せ てし まいましょう （リス 卜 1-1)〇 なぜた っ 
た 4 行 だけの 変史で マルチ ファイル テキスト エディタが できて しまう のか、 変史简 所の 少 
なさに 反して、 これを 理解す るた めには フレームワークの エッセンス ともいうべき 部分に 
まで 触れなければ なりません 0 それでは、 この 4 行を 理解す るた めに、 ドキュメント テン 
プレートと シリアライズ にっいて 説明して いきます。 
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変更 H 所の すべて 



BOOL CMMView: :lnitlnstance() 

{ 

…略 

CMultiDocTemplate* pDocTemplate; 
pDocTemplate = new CMultiDocTemplate( 

IDR.MMVIEWTYPE, 

RUNTIME-CLASS (CTextEditDoc) , 

RUNTIME-CLASS(CChildFrame), // カスタム MDI 子 フレーム 
RUNTIME-CLASS (CEditView) );// CTextEditView を CEditView に 変更 
AddDocTemplate (pDocTemplate) ; 

…略 



void CTextEditDoc: : Serialize (CArchiveft ar) 



POSITION pos = GetFirstViewPositionO ; 
CView* pEv = GetNextView(pos) ; 
((CEditView*)pEv)->SerializeRaw(ar) ; 



// 以下 3 行を 追加 



1.5 CEditView クラスで 楽しょぅ 

まずは 第 1 の 変 史 点から 兄て いくこと にしましょう。 

さきほど わざわざ 名前まで 変！ ii して CTextEditView クラスを 作り ましたが 、欠は この 
クラスは 使いません 。というのは、 まさに テキスト エディタを 作る ために あるかの ような ク 
ラスが MFC に IIJ 总 されて いるから です。 この クラスは 「CEditView」 といい、 CCtrlView 
クラスの 派 也 クラスです。 CEditView クラスは# 常に 多 機能な クラスで、 内部で エディ ッ 
ト コントロールを 使う ことにより、 テキス 卜の 褊浓や クリッブ ボードとの カット & ペース 
卜、 テキス 卜の 検索 丨? (換 などを -T •に 引き受けて くれます。 CEditView クラスを ビュー 
クラスと して 採〗 I] すると、 たちどころに テキス 卜 エディタの できあが りです。 もっとも、 エ 
ディ ット コントロールには 64K バイト 以上の テキストを 編圯 できない という 制 吸が あるの 
で、 CEditView クラスを 使った テキス 卜 エディタで 褊染 丨丨] ■能な ファイル サイズは 64 k バ 
イトに 制限され ます。 

それでは、 どのように すれば ビュー クラスを CTextEdit View クラスから CEditView ク 
ラスに 変！ C できる のでし ょうか？ その 答は MMView.cpp にある CMMViewApp::InitInstan 
ce_ 数に あります 。この 中に 次の ような 行が あります, 
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CMultiDocTemplate* pDocTemplate ; 
pDocTemplate = new CMultiDocTemplate( 

IDR_MMVIEWTYPE, 

RUNTIME_CLASS(CTextEditDoc) , 

RUNTIME_CLASS(CChildFrame) ,// カスタム MDI 子 フレーム 
RUNTIME_CLASS(CTextEditView) );" CTextEditView を CEditView に 変更 
AddDocTemplate (pDocTemplate) ; 



ここで アプリケーションが 利) li する ビュー や ドキュメントの クラスを 指 走して いる ことが 
直感的に わかる でしょう 。この 「CTextEditViewJ を 「CEditViewJ に 書き換えれば、 ビ ュー 
クラスと して CEditView クラスが 使われる ようになる のです。 

もう 少し 細かく 见 てみ ましょう。 まず new 演 切: を 使って CMultiDocTemplate クラス 
の オブジェクトを 作成して います。 CMultiDocTemplate クラスの 才 ブジェク ト はドキ ュメ 
ン卜 テン ブレー 卜と 呼ばれ、 1 つの ドキュメント タイプを 定在 します。 ドキュメント テン 
プレートは、 以下の ように リソース/ドキュメント クラス MDI の T ウインドウの フレー 
ム ウィンドウ クラス 子 ウインドウの ビュー クラスの 4 つの パラメータから 構成され てい 
て、 ドキュメント 夕 イプの 性格が ここで 決まります 。作成した CMultiDocTemplate 才ブ 
ジェ クトを AddDocTemplatelltJ 数を 使 州して、 ドキュメント テンプレートの リストに 追 
加して いる わけです 。ドキュメント テンプレートは 灾行 時に ウィンドウを 作成 するとき に 
アプリケーション クラスの オブジェクトから 参照され るよう になって います。 

new CMultiDocTemplate ( " MDI ドキュメント テンプレートの 作成 

リソース， //CMultiDocTemplate クラスの コンストラクタへの 引数 

ドキュメント クラス， 

子 ウィンドウ 用の フレーム ウィンドウ クラス， 

子 ウィンドウ 用の ビュー クラス 

)； 

リソースに ついては あとで 詳しく 説明す る ことにして、 残りの 3 つの クラスの 説明を 
してし まいましょう。 分鉍 する クラスは、 RUNTIMELCLASS マクロを 使って 指定し ます 
( RUNTIME_CLASS マクロに ついては 次 節で 詳しく 説明す る） 〇 3 つの クラスは 前から、 
ドキュメント クラス 子 ウインドウの フレーム ウインドウ クラス， 子 ウインドウの ビュー 
クラスの 順に 指记 します。 ビュー クラスと ドキュメント クラスには 、麻 接 CView クラス 
や CDocument クラスを 指逛 せずに、 その 派生 .クラスを 指定し なければ なりません 。また、 
フレーム ウインドウ クラスには、 デフ オルトでは CMDIChildWnd クラスの 派生 クラスで 
ある CChildFrame クラスが 使用され ます 〇 CChildFrame クラスは AppWizard が 定義し 
た クラスで すが、 その 中身は 空な ので CMDIChildWnd クラスを そのまま 利) 1丨 した 場 介と 
変わりありません。 
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作成した ドキュメント テンプレートは、 CWinApp :: AddI)ocTemplate|iy 数を 使って ド 

キ ュメ ント テンプレートの リストに 众鉍 して おきます。 すると、 あとで [ファイル] 一 [新 
规作 成] が 選択され たと きな ど、 新規に ドキュメントを 作成す る 際に フレーム ワークから 
参照され、 その 結: ウィンドウが 新規に 作成 衣/〗 i される ようになります y 

ドキュメント テンプレートに 众鉍 する ビュー クラスを 変; する ことで、 CEditView クラ 
スが利 川 できるようになる ことが わかった でしょう か？ これが 第 1 の 変 史 点の 现丨 丨丨 です。 

Q 1 なぜ AddDocTemplate 関数は 丨 nitlnstance 関数の 中で 呼ばれて いるので すか？ 

A1 ドキュメント テン ブレー 卜は インスタンスの 初期化 時に 一度 だけ リス 卜に 登録す 
れ ばいい からです。 

何ら かの 処观を 行いたい というと きに、 その 処观を •记述 する 関数を MFC が 提供す る 多 
くの （仮想） 閲 数の 中から 選択す る 族 中は、 行う 処理の 内袢 と閲 数が 呼ばれる タイミング 
にあります。 たとえば、 ここで 行う 処押 •は ドキュメント テンプレート という オブジェクト 
を 作成し それを テン プレー 卜の リストに 众鉍 する ことです 3 ドキュメント テンプレートは 
W: 初に ドキュメントを 丨谢く 前に/ 6 低で も 1 つは 分録 されて いなければ いけませんし、 •度 
作成され た ドキュメント テン ブレー 卜は アプリケーションが 終 f する まで 削除す る こと も 
できません 。また、 M じ ドキュメント テンプレートを ••度 分鉍 しても 無焱 味です。 そこで、 
アブリ ケー シ ョンの 起動時に •度 だけ 呼び出される Ini t l nstance 間数で ドキュメント テン 
プレー 卜の 记義を 行う のです 。 

Q2 ドキュメント テン ブレー 卜 オブジェクトを new 演算子で 作成して いるに も かかわ 
らず 、なぜ どこでも delete していな いのです か？ 

A2 フレームワークが 自動的に 削除して くれる からです。 

•般に new 演 WY •を 使って オブジェクトを 作成した 坳 合は、 delete 演灯户 を 使って オブ 
ジェク 卜を 削除す る必贤 があります 3 

しかし、 ドキュメント テン プレー 卜の オブジェクトに ついては、 nevv 演灯 ，•で 作成して 
いる にもかかわらず、 どこに もこれ を 削除す る コードは 兑、レ 丨 たりません。 これは 別に 才ブ 
ジェク 卜を 削除す る必 •&: がない わけでは なく、 フレームワークの 中で 後始 未が 付けられる 

ようになっ ている からです。 これは 比較的 特殊な 例な ので、 荇 段は 忘れずに ddete 演益子 
で才 ブジェク 卜を 削除す るよう にして ください。 

なお、 逆に フレームワークの 中で 作成され た才 ブジェク 卜を 勝 丁: に 削除して しまわな い 
ように きをっけましょう。 
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1.6 RUNTIME.CLASS 

少 々詁が 脇 に それて しまい ますが、 ここで さきほど 出て きた RUNTIME J ： L ASS マク 
口につ いて 評しく 説明す る ことにします。 もう 一度 リストを U てみ ましょう。 

CMultiDocTemplate* pDocTeraplate ; 
pDocTemplate = new CMultiDocTemplate( 

IDR.MMVIEWTYPE, 

RUNTIME-CLASS (CTextEditDoc ) , 

RUNTIME-CLASS(CChildFrame), // カスタム MDI 子 フレーム 
RUNTIME_CLASS(CTextEditView)) ; //CTextEditView を CEditView に 変更 
AddDocTemplate (pDocTemplate) ; 



RUNTIMELCLASS マクロは CMultiDocTemplate クラスの コンストラクタの 引数に 使 

⑴ されて います か' 火は この マクロを 利 川す る ことにより コンストラクタには クラスの 才ブ 
ジェク 卜では なく、 クラス 「丨 休が 渡されて いるので す。 いう なれば、 変数では なく、 変数の 

期 が 渡されて いるよう な ものです C + + ■ iVift では、 RTTI (RunTime Type Information : 
ランタイム 型 情報） により、 火 行 詩の 叩 •を 扱う ことができる ようになり ましたが、 MFC で 
は灾 行峙 に沏を 扱うた めに この 機能を 使 川して はいません 0 か といって 別に visual C + + 
の処 列 系が 拡张 されて いる わけで もな く、 いくつかの マクロを 組み 介 わせて、 擬似 的に クラ 
ス という 才 ブジェク 卜の 喂を閲 数の リ丨 数と して 渡す ことができる ようになって いるので す。 

火 行畤に 咽 惝 報を 扱える ようなし くみを 川总 した 人き な 原因と して あげられ るのは、 
Windows アブリ ケー シ ョン （とりわけ、 MI ) I アプリケーション） では、 ユーザーが [ファ 
イ ル]-; 新 觇作 成： などを 選択した ときに# 的に ウィンドウを 作成 するとい うこと です, 
MFC を 利 川した 場 介、 1 つの ウィンドウは フレーム ビュー ドキュメント/リソース か 
ら構 成される ことは すでに 述べました が •、アプリケーションは これらの 惝 報を ドキ ュメン 
ト テン ブレー 卜の 形で 竹 列! •し、 必贤 なと きに 必要な だけ その オブジェクト （すなわち ウィ 
ン ドウ） を 作成す るので す。 とくに 极 数の ドキュメント タイプを 扱ったり、 j つ の ド キュメ 
ン トに攸 数の ビューが あるよう な アプリケーションの 坳介 には、 ユーザーの 選択に よって 
どの ドキュメント テンプレートを 利 川して ウィンドウを 作成す るかは アプリケーションの 
火 行 時に ならない とわ かりません 0 このように、 火 行峙 に 初めて 作成す る才 ブジェク 卜の 
喂 （クラス） が 決： ゼ する ような 場 介には、 才 ブジェク 卜の喂 を 閲 数の リ丨 数と して 渡せる こと 
が必贤 になって きます。 

MFC では、 これを RUNTIM 1{_ CLASS マクロを 使って 义现 しています。 RUNTIME 一 
CLASS (く クラス 私〉） マクロは、 （ JRuntimeC 丨 ass クラスの オブジェクトへの ポインタを 
返します： く クラス 名〉 に 対 丨芯 した CRuntimeClass クラスの オブジェクトを 使う と、 表 
1-3 にあげる マクロの 利川ガ 法に よって 、 3 M 類の サービスの いくつかを 受ける ことが で 
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種類 


クラスの 定義 部 


クラスの 実装 部 


サービス 


DYNAMIC 


DECLARE.DYNAMIC 


IMPLEMENT-DYNAMIC 


isKindOf 関数 


DYNCREATE 


DECLARE.DYNCREATE 


IMPLEMENT.DVNCREATE 


の 利用 

オブジェクトの 


SERIAL 


DECLARE.SERIAL 


IMPLEMENT.SERIAL 


動的な 作成 
シリアライズ 



表 i -3 3 種 a の サービスを 提供す る マクロ 



きます 。先に 述べた 動的な 才ブジ ヱ クトの 作成は、 3 神 類の サービス のうちの 1 つ です c 
表 1-3 に 小した マクロは、 2 つで 1 紐に なって いて、 DECLARE - 〜 マクロは クラスの 定 
戒部、 IMPLEMENT _〜 マクロは クラスの 災災 部で 使います。 たとえば、 c TextEditD〇c 
クラスでは リス 卜 1-2 と リス 卜 1-3 のようにして DECLARE _ I ) YNCREATE マクロと 
IMPLEMENT _ DYNCREATE マクロを 利 ⑴ しています。 

リスト 1-2 クラス 定親 内で 利用す る マクロ （ TextEditDoc.h) 

class CTextEditDoc : public CDocument { 
private : // シリアライズ 機能から のみ 作成し ます。 

CTextEditDoc () ; 

DECLARE_DYNCREATE(CTextEditDoc) // クラス 定拜 部での マクロの 利用 

//アトリビュート 

public: 



リス 卜 1-3 クラスの 実装 内で 利用す る マクロ （ TextEditDoc.cpp) 



11111111111111111111111111111111111111 
// CTexteditDoc 

IMPLEMENT_DYNCREATE(CTextEditDoc , CDocument) // 実装 部での マクロの 利用 
BEGIN_MESSAGE_MAP(CTextEditDoc , CDocument) 



クラスの 定義に、 いずれの マクロ も利丨 丨丨 していない 坳介 には、 その クラスを 
CLASS マクロの リ丨 数と して 兮 える ことは できません。 

DECLARELDYNAMIC マクロと IMPLEMENT _ DYNAMIC マクロを 利 坩 した クラス 

では、 IsKindOf 閲 数を 使つ て、 ある 才 ブジェク 卜が どの クラスから 作られた ものな のか 調 
ベる ことができます 。これを 利〗 | J すると、 ある クラスの オブジェクトへの ポインタが、 本 
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4 に その クラスの オブジェクトを 指して いるの か、 それとも その 派 小 クラスの 才 ブジェク 
卜を 指して いるの かを 知る ことができます。 たとえば、 以 ドの ような 場 介です 。ここでは、 
CDocument クラスの オブジェクトへの ポインタが 渡された 関数の 中で、 その 才 ブジェク 
卜の 本、 1 ' 丨の喂 （クラス） を 利 断す るのに IsKindOf 関数を 利 JH しています 。 



void f 〇 o(CDocument* pDoc){ 

if (pDoc->IsKindOf (RUNTIME.CLASS(CTextEditDoc) ) ) 

{ 

く pDoc が CTextEditDoc クラスの オブジ i ク 卜を 指して いる 場合の 処理〉 

> 

else 

く pDoc が CTextEditDoc クラス 以外の オブジェクトを 指して いる 塲 合の 処理〉 

} 

} 

I ) IiCLAKK _ l ) YNCKI*:ATli マクロと I \ n ) LIiMIiNT _ I)YNCKIiATE マクロを 利 川した 
クラスは、# 的に オブジェクトを 作成で きる ようになります。 CView クラス や CI ) oa 丨 ment 
クラスの 派 十 •クラスは、 フレームワーク によって 動的に オブジェクトが 作成され るので、 
かならず この マクロを 利 川し なければ いけません， 

DECLARE _ SERIAL マクロと IMPLEMENT - SERIAL マクロを 利 州した クラスは、 
> >演 灯， •や < <演灯 f •を 使って シリアライズ できる ようになります （シリアライズ にっ 
いては 次 節 以降で 説明す る）。 なお、〜』 YNCKEATE マクロは〜 J ) YNAMIC マクロの 
機能を すべてたん で おり、〜 _ SFAIAL マクロは〜 _ I ) YNCREATE マクロの 機能を すべて 
含んで います。 

1.7 ドキュメント クラスの 実装 

ビューの 灾焚は ドキュメント テンプレートの 惝 成を 変 して、 ビュー クラスに CEditView 
クラスを 利⑴ する だけでした。 次に ビューと 対になる ドキュメントの 火 焚に ついて 説明し ま 
しょう。 この 2 つの 火 焚が 済んで 初めて プログラムは 总 味の ある ものと なる のです。 さて、 
ドキュメントの 戈 装は、 -般に メンバ 変数の 追加と、 Seria 丨 ize 閲 数の 記述が その 中心的な 
作 尨と なります ，メンバ 変数は、 ドキュメントの 本 体 （たとえば テキスト ファイル） やその 
W 竹 •（テキスト ファイルの サイズな ど） を 保存す るのに 使います。 Serialize 問 数は 、 MFC 
が 提供す る 仮想 問 数の 1 つで、 ドキュメントの 丨人 J 料を アプリケーションと ファイルとの |!|j 
で やり取りす るのに 使います 。ドキュメント クラスの 欠 装 •を 始める 丨 iin こ、 まず Serialize 閱 
数に っいて 少し 説明し ましょう。 
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參 Serialize 関数 

MFC が 取り入れて いる:® 要な 概念の 1 つが シリアライズです。 シリアライズの || 的は、 
「保存し、 冉 利用す る 価侦の あるす ベての クラスには、 統 •された ファイル 人出 力の イン 
夕 一 フェイスを 提供す る」 というと ころに あります 。そして、 その インターフェイス にあた 
るの が Serialize 間数です。 

たとえば 、ドキュメント クラスには、 保存し、 洱 利) |j する 価侦の ある データが 含まれて 
いる ことは いうまで もありません 。そこで フレームワークは ドキュメント クラスの 才ブ 
ジェク 卜を フ ァイ ルに 保存したり 、ファイルから 説み 込む ときに、 ドキュメント クラスの 
Serialize 閲 数を 呼び出します 。そして、 プログラマが フレームワークの 规定 する 仆様 に從っ 
て Serialize 関数を 実装 すれば、 ファイルとの 人出 力が 簡单に 行える ようになります。 

それでは、 Serialized 数を 使って 決められ ている シリアライズの 統 .的な インター フェ 
イスとは どのような ものな のでし ょう。 ここでは、 AppWizard が 牛 成した Serialize 間数 
を 例に 説明し ます 〇 AppWizard が 牛 •成した Seria 丨 ize IKI 数は、 リスト 1-4 のよう な コード 
です。 なぜ このような コードが すでに 問 数の 本体に 尨され ている のでしょう。 

リス 卜 1 -4 変更 前の CTextEditDoc::Serialize 閬歆 

void CTextEditDoc : : Serialize (CArchiveft ar ) 

{ 

if ( ar . IsStoringO ) 

{ 

// TODO : この 位置に 保存 用の コードを 追加して ください。 

} 

else 

{ 

// T 0 D 0 : この 位* に娩み 込み 用の コードを 追加して くださ ぃ。 



灾 は、 ドキュメント クラスの Serialized 数は ブロ グラマが if 丨:接 呼び出す のでは なく、 フ 
レーム ワークに よっ て 呼び出される のです。 よって、 Serialize 問 数を 灾装 する 際には、 そ 
の 引数と 返り 侦を フレームワークの 期待 どおりに 扱う ことが 觅要 になって きます ここでは 
返り 値は void ですから 考える 必要はありません。 問題は リ丨 数です。 引数には CArchive ク 
ラスの 才 ブジェク 卜 ar が フレームワークから 渡されて います。 CArchive クラスは、 ファ 
イル 入出力を 行うた めに MFC が 提供して いる クラスで、 シリアライズと 密接に 問 速して 
います。 そ 一 で、 次 取では 少 々か •り 道を して CArchive クラスに ついて 解 •兑 します， 
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• CArchive クラス 

cm 語に よる プログラミングの 経験が ある" は、 挖渾 人出 力を 使った ファイル アクセス 
について はよ くご 徉じ でしょう。 これは 0S や シェルに よって 炎现 されて いた パイプ やリ 
ダイレク 卜と いった 機能を 前提と した インターフェイスでした 。從 来の コマンド ライン イ 
ン夕ー フェイスを 川いた 場 介には、 こうした インタ一フェイスは 非常に 便利で 使いやすい 
ものでした が'、 Windows のよう な GUI ベースの システムでは イ丨 •効に 機能し ないで あろう 
ことは 矜 易に 想像で きます。 また Visua 丨 C + + のように C + + 贡 語を 使う 場合に も、 C 言 
語とは 迫った、 C+ + •丨 ••沿に 適した インターフェイスが 求められます， 

こうした 贤求に 応える のが CArchive クラスです、 CArchive 才 ブジェク 卜を 作成す る 
と、 その オブジェクトは 人出 ノ J の 対象と なる ファイルと 1 対 1 で 対 It 付けされ、 次の よう 
な インターフェイスで 、ファイルに 対して 人丨 丨丨乃 をむ うこと がで きる ようになります 0 そし 
て、 この 人出 ノ J の屮 心と なる のが、 >>演 灯， •（•泣み 込み） と <<演 灯，. （ •丨丨 •き 出し） です 0 

mt number = 5; 

CString message = "Select number : ; 
if (ar • 丄 sStoringO) 

ar << message << number; // "Select number' 5 を 出力 
else 

ar >> message >> number; //CString 型 ，int 型を 入力 

>>演«: ， •とくく 演 ，•といえば、 C i 丨 •語では int 喂 の侦 をリ丨 数に 取る ビット シフト 演 切: 
: f でした。 しかし C+ + •肯 語では それだけではありません。 C+ + , f 語では、 問 数と M 様、 
侦«:イ •の 動作 も ブロ グラマが H 丨 丨 丨に定 在で き、 さらに、 M じ演兑 P でも 引数の 沏 によって 
W なる# 作を 记在 できる ようになって います。 2 つの int 喂 変数を リ丨 数と して >>演灯 を 
使えば、 C •丨 •語と 丨"1 様に ビット シフト 演筘が 行われます 。しかし | •.の 例の ように、 A: 取を 
CArchive クラスの オブジェクト 、心 •埙を int 咽 変数と して〉〉 演 灯， •を 使えば、 CArchive 

クラスの メンバ 間 数と して 定 在され ている >>演 灯广が 使われる ことにな り、 ファイルと 
の 人出 力が 行われます。 

mt a, b; 

CArchive ar; 
a « b; // ビット シフト； 寅 班 
ar くく a; "ファイルへの 出力 
ar >> a; // ファイルからの 入力 

このような CArchive クラスの インタ一フェイスには 2 つの メリットが あります。 1 つ 
は才 ブジェク 卜の 喂 チェックが コンパイラ によって 「丨 動的に 行われる ことです 。たとえば、 
printf 関数 や scanf 閲 数を 使った ファイルの 人出 ノ j では、 人出 ノ j フォーマット （％ vS や％ c 、 
など） とリ丨 数の 整合性は プログラマが f び I! •する 必要が ありまし たが、 CArchive クラスを 使 
え ば、 人出 ノ J をむ う才 ブジェク 卜の 喂に対 化した 間数を 呼び出す ように コンパイラが 処现 
して くれます。 もう 1 つは、 プログラマが 作った クラスの 才 ブジェク 卜に 対する インター 



1 テキス 卜 エディタを 作って みよう 



フェイスを W 幼に 追加で きる ことです。 primf 閲数や scanf 関数では、 intM や char 型と 
いった プリ ミ テ ィブな 喂 しか 人出 カフ ォー マットを 指定で きませんで したが、 CArchive ク 
ラスを 使えば、 プログラマが ； 述 した クラスの 人出 力を i nt 喂や C h ar 彻 と |,,j じように〉〉 
演 灯， •や << 演 W / •を 使って むう ことができます 3 

鲁 Serialize 関数の 標準 的な 構造 

Serialize 問 数の リ丨 数に i •度され た CArchive オブジェクト ar を 使えば、 ファイルの 入 山 
ノ J がで きる ことは わかりました 。しかし、 Serialize 閲 数の 中で、 どの ファイルに アクセス 
する のかは どうやって 知る のでし ょうか？ なにせ、 Serialize 閲 数の リ丨 数には ファイル 名な 
ど 渡されて いないの です。 

火は そんな ものは ブロ グラマが 竹 那 •する 必要は ない のです 0 というのは、 Serialize 問 数 
が丨丨 f び 出される ときには、 フレームワーク によって ar に 対応す る ファイルは すでに オーブ 
ン されて いるから です ここに ヤ: るまでに フレームワークは、 [ファイルを 開く] などの ダ 
イア ログを オーブンし、 そこで ユーザーが 指记 した ファイルを オープンして くれる のです。 
つまり、 Serialize 間数の 屮 では、 ブロ グラマは ファイルの 人出 力に 関する コード だけを 記 
述 すれば よいので す Serialize 間 数が 終 广 すれば、 ファイルの クローズ も フレームワーク 
が 行って くれます。 

ダイアログ ボックスを 使った ファイルの 迸択や ファイルの オーブン といった 丨〖 丨丨 •倒な 作 策- 
を フレームワークが; 丨丨 •代わりして くれる のは 松し い则 りです が、 そうすると 次の 叫 題が 
记 1: •します 〇 C • 丨 ••冶で f () pen 数な どを 使って ファイルを オープン するとき には、 ファ イ 

ル 7 •ともう 丨つ 、•ぬみ 込み や •丨丨 : き 込みと いった モードの 指定を |"j 叫に 行いました。 しかし 
MFC を 使っ た ブロ グラムでは •染み込み か 押き 込み かに かかわらず、 呼び出される 関数は 
常に Serialize 間数です 。それでは、 Serialize 問 数の 中では、 どのように 説み 込みと, 丨丨: き 込 
みの 処列 •を K 別して 行えば よいので しょうか？ 

この K 別を する コード こそが AppWizard が 少 成した Serialize 閲 数に あった コードな の 
です > という わけで、 ここでもう •度 AppWizard による コードを U てみ る ことにし ま しょ 
う （リス 卜 1-5>〇 

リス 卜 1-5 AppWizard が 生成した Serialize 関数 

void CTextEditDoc: : Serialize (CArchivefe ar) 

{ 

if (ar • IsStoring () ) 

{ 

// TODO: この 位 * に 保存 用の コー 卜-を 追加して くださ い。 



else 
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// TODO: この 位 S に 読み込み 用の コードを 追加して ください 



CArchive クラスには、 CArchive クラスの 才 ブジェク 卜が， 说 み 込みと， t き 込みの どちら 
の モードで オーブン されて いるかを, M ベる、 IsStoring 問 数と IsLoading 関数と いう 2 つ 
の メンバ 関数が 州 意され ています 〇 IsStoring 間数は 対応す る ファイル が逬き 出し 1H に オー 
ブン されて いれば TRUE を、 説み 込み 川に オープンされ ていれば FALSE を 返します。 ま 
た IsLoading 1541 数は IsStoring 間数とは 逆に、， 说み 込み 川に オープンされ ていれば TRUE 
を、 押 き 出し 用に オーブンされ ていれば FALSE を 返します。 すべての Serialize 間数で 
は、 かならず この どちら かの 問 数を 使って 処观を 振り分ける 必要が あります。 

• SerializeRaw 関数 

前 JJ： (では •般 的な Seria 丨 ize 閲 数の 構造に ついて 説明し ましたが 、先は CTextEditDoc::Se 
rialize 問 数に 次の コードを 妃述 する だけで、 + 節での 丨丨 的の 作 袋は 义广 してし まいます （リ 
スト 1-6>〇 今までに 説明した ような シリアライズが 火 除には どのよう にして 行われて いる 
のかに ついては 2 ヴで U て もらう ことにして、 ここでは MFC が 提供す る 機能を 使って 楽 
をして しまい ましょう 0 

リスト 1 -6 CTextEditDoc: :Serialize 関数 （ TextEditDoc.cpp) 

CTextEditDoc: : Serialize (CArchivefe ar) 

{ 

POSITION pos = GetFirstViewPosition(); // ビュー 才 ブジェク 卜を 取得す る 準備 
CView* pEv = GetNextView(pos) ; // ヒュ— オブシエ ク 卜を 取得 

( (CEditView*)pEv)->SerializeRaw(ar) ; // SerializeRaw 間数を 呼び出す 



ポイントは CEditView::SerializeRaw IW 数に あ丨） ます： この 関 数は CEdit View クラスの 
メンバ 問 数と して 呼び出され ている ことから も わかる ように、 CliditView クラスの サービ 
ス として 川 立され ています 。つまり CEditVicw クラスは、 ビュー クラス イく 来の 丨| 的で ある 
ユーザー インターフェイスの 竹那 以外に も、 シリアライズを 禽 めた ドキュメントの 竹 刊丨ま 
で 受け持って いるので す （CEditView::SerializeRaw 閲数 内では CArchive::IsStoring|Sy 数 
を 利 川して •般 的な Serializem 议と l"j 様な 処种を 行って いる）。 このため、 （JTcxtliditl)oc 
クラスには メンバ 変数を 迫 加す る必贤 もなければ、 ファイルとの 人出 ノ j を 行う コードを,; ti 
述 する 必要 もありません。 



とはいえ、 それほど 簡 中. に SerializeKaw 問 数を 呼び出せる わけではありません。 なぜな 
ら、 SerializeRaw 閲 数は CEditView クラスの メンバ 閲数 であり、 CTextEditDoc クラスの 
メンバ 閲数 である Serialize 閲 数からは II* 丨:接 呼び出す ことは できない からです。 そこで、 ま 
ずは CEditView クラスの 才 ブジェク 卜への ポインタを f •に 人れ る 必要が あります。 そこで 
众坳 する のが、 の W 頒で表 1-1 にあげた GetFirstViewPosition 関数と GetNextView 
関数です。 これら 2 つの 間数は、 ドキュメント クラスから ドキュメント テンプレートを 介 
して 問 連 付けされ た ビュー クラスの オブジェクトを 知る ために 使います 。逆に ビュー クラ 
ス で、 ビューに 閲迚 する ドキュメント クラスの 才 ブジェク 卜を 知る ためには、 各 ビュー ク 
ラスで 才ー バーラ イドされ た GetDocument 閲 数を 使います 0 

Q1 GetNextView ( GetFirstViewPosition ( ) ) と 記述 すれば 1 行で 済む のでは？ 

A1 実はそう はいきません。 

なぜなら GetNextView 関数の リ丨 数の 咽は POSITION& という POSITION 喂の 参照* 1 
だからです 〇 C+ + 丨丨 には、 参照の 変数に 代人 するとき の“ 辺侦は 変数で なければ なら 
ない のです が、 閲 数の 引数が 参照のと きに もこれ を マる 必贤 があります 。つまり、 参照の 
リ丨 数を 取る 間数には、 変数を 介さなければ fi/ (を 渡せない のです， 

2 行に 分けて A かなければ いけない のは 丨 〖丨 j 例です が、 もちろん 师丨|丨 も なく、 このように 
なつて いる わけではありません 〇 GetNextView 関 数の 内部では、 リ丨 数に 渡された 変数 （pos) 
の侦を 参照した あとに、 次の ビュー 才ブジ ヱ クトを 指す ように その 侦を 変； ii している ので 
す 〇 W (を 変! li する からには、 関数の 返り 侦 ではなく 変数を 渡さなければ ならない のは 当然 
です。 こうした 仆様 にす る ことで、 以ド のように 繰り返し GetNextView 間数を 呼び出す 
だけで 順に ビュー 才 ブジェク 卜への ポインタを: f •に 入れる ことができる のです。 

CView* pv; 

POSITION pos = GetFirstViewPositionO ; 

while (pos) { // これ 以上 ビューが なければ p〇s==NULL 

pv = GetNextView(pos) ; // ビューを 入手， pos は 次の ビューを 指す 

< ビューに 対する 操作 > 

> 

ただ、 この ブロ グラムでは 1 つし か ビューを 利〗 H していない ために、 こうした インター 
フェイスの 利办 よりも-: 度 T •問の if 丨丨 •倒さが II 、X って しまって いるので す。 



* 1 参照に ついては Appendix A を 参照 
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Q 2 CEditView クラスが ドキュメントの 管理まで 行って いるが、 これは 本来 ド キュメ 
ン卜 クラスで 行うべき 作業では ないか？ 

A 2 まったく そのと おりです。 

CEditView クラスは 非货に 特殊な 惝成 をした クラスで、 1 つの クラスで ビュー クラスと 
ドキュメント クラスの 丨山丨 力の 機能を 持って います， これは、 CEditView クラスが 継承され 
る ことを とくに 芩丨 返して いなかったり、 极 数の ビューに 対応した ドキュメント 竹 押. をす る 
つもりがない ためです。 っまり、 CEditView クラスは すでに それだけで 完成され た クラス 
であるた めに、 このよう になって いるので す， こうした クラスを •する ことは できます 
が、 後々 のこと をち •えて、 できるだけ ビューと ドキュメントは 分けて •した" がよ いで 
しょろ 0 

「丨 分で クラスを 設, 丨丨 •するとき は、 どこまでを ビュー クラスで、 どこまでを ドキュメント 
クラスで 扱ったら よい かは 悩む ところでは あると 恐 いますが、 2 っ以丨 •.の ビューを 想^し 
てみ ると はっきりし てきます 。ビューに 依む: せずに 常に 必贤 になる ti •丨钳 は ドキュメント ク 
ラスで 竹 利し、 それ 以外の t /丨 報は ビュー クラスで 竹 押. すれば よいので す。 

以丨 •.で 変史を 加える 4 行の コードに ついての 説明は 終わ 丨） です 。あとは リソースに 乎を 
加える だけで テキス 卜 エディタが できあがります。 

1.8 リソースの 編集 

少し 站 •が もとに/ 乂丨） ますが、 AddDocTemplateTO 数の 説明で、 ドキュメント テン ブレー 
卜を 構成す る パラメータの 1 つに リソースが あると 述べました。 火は この パラメータは、 
メニュー や アイコン 、ストリング テーブル など、 いくつもの リソースを M 時に 指定して い 
るので す 。これらの リソースを これから リソース エディタで 褊災 していく ことにします （図 

1 - 4)〇 

AppWizard の 作つ た リソース 

では、 エディ 夕 川の リソースの 作成を 行う ことにし ましょう。 [衣 尔]— [プロ ジェク 
トワ 一 クス ペース] を 選択して ワーク スペース ウィンドウを 衣ボ させ、 [R esource View] 
タブを クリックして、 リソース- 沒 を衣氺 してく ださい 〇 今 衣, されて いる リソースは 
八 ppWizard が 十. 成した、 いわば デフ オルトの リソースです。 これを アプリケーションに 合 
わせて リソース エディタを 使って# き 換える のが これからの 作衮 です。 

ところで、 これらの リソース すべてが ドキュメント テンプレートに 夺録 されて 利〗 II され 
る わけでは なく、 ある ものは フレームワークから 参照され、 ある ものは プログラマが, ki 述し 




図 1-4 リソース エディタ 



た コードから 参照され ます〉 では、 ドキュメント テンプレートに 众鉍 される リソースとは、 

どの ことなので しよう？ もう •度 CMMViewApp :: InitInstance 関 数で AddDocTemplate 

閲 数を 呼び m している 部分を U てくだ さい, 

CMultiDocTemplate* pDocTeraplate ; 
pDocTemplate = new CMultiDocTemplate( 

IDR.MMVIEWTYPE, 

RUNTIME_CLASS(CTextEditDoc) , 

RUNTIME_CLASS(CChildFrame), // カスタム MDI 子 フレーム 
RUNTIME_CLASS(CTextEditView)) ; //CTextEditView を CEditView に 変更 
AddDocTemplate (pDocTemplate) ; 

CMultiDocTemplate クラスの コンストラクタに 渡す 鉍 初の 引数が リソースの 指记 です 
から、 IDR - MMVIEWTYPE が夺鉍 する リソースを ポ しています。 そこで、 シンボル ブラ 
ウ ザを 使っ て ni ) R _ MMVIKWTYPE ：」 という リソース II ) を 探して みましょう。 メニュー 
から [炎 小]- [シンボル ブラウザ： を 選択す ると シンボル ブラウザが 起勋 されます シ 
ン ボル ブラウザには 现/ 丨： 记義 されて いる シンボルの •泣が 衣, される ので、 この 中から 
II ) R _ MMVIEWTYPIi を 選びます 。すると アイコン メニュー ストリング テーブルの 3 
つの リソースに |" j じ II ) R _ MMVIE \\ TY 丨) E という リソース II ) が 割り、 丨 '丨 てられて いる こと 
がわ かります （図 1-5>。 



ソースの 編集 



aa 



で 使用 さ 



PVfilD 



9 



PVR1C3 



印 



m 



ースの 種類 






表 1-4 ド 

ニュー だけでなく、 アイコ: 
众鉍 された ものが 使われ ま_ 



ドウを 最小化した ときに 表示され る アイコン 
• ウを アクティブ にした ときに 使われる メニュー 
タイトル や ファイル タイプに 表示され る 文字列 



ツ卜 キ一 



ー 卜に 登録す る リソース 



一夕 テーブル も、 ドキュメント テン プレー 






1.8 U ソースの 編集 



リソースの 種類 


用途 


アクセ ラレータ 


ドキュメントに 依存し ない ショー 卜 カット キー 


ビットマップ 


ツール バーに 表示され る ビットマップ 


アイコン 

— — ■ 1 


アプリケーションを 最少 化した ときに 表示され る アイコン 


メニュー ’ 


子 ウィンドウが 存在 しないと きに 使われる メニュー 


ストリング テーブル 


メインフレーム ウインドウの タイトル 



表 1-5 メインフレーム ウインドウに 付随す る リソース 



ス卜 リング リソース 

アイコン リソース ■ 

-)ra<V —4 




図 1-7 メインフレーム ウインドウに 付随す る リソース 




AppWizard が 屮 成した リソースの 説明が 济ん だと ころで、 IDR _ MMVIEWTYPE が 示 
す リソースを 編染 する ことにします 。しかし、 その 前に、 IDR _ MMVIEWTYPE という 名 
前は そぐ わない ので 名 前 を 変 〇 i する ことにしましょう。 というのは、 MMView というの 
は アプリケーションの 名丨 •丨! j •である にもかかわらず、 II ) r _ MX '1 VIEWTYPE が 衣して いるの 
は 1 つの ドキュメント テン ブレー 卜に 閲迚 付けられた リソースです。 极 数の ドキュメント 
テン ブレー 卜を 使 丨丨丨 する坳 合に、 1 つの ドキュメント テンプレートに アプリケーション 名 
を 付ける のは 適、 レ丨 とはいえない でしょう 。そこで、 II ) R _ MiMVIEWTYPE という 名前の リ 
ソースは、 ワーク スペース ウィンドウから その 名前を すべて 「 IDRTEXTEDITTYPE 」 に 
変史 してし まいましょう （図 1-8)。 

また、 これに 介 わせて プログラム 丨 •.でも IDR - MMVIEWTYPE を 参照して いた 简 所を 
IDR _ TEXTEI ) ITTYPE に# き 換えます。 といっても、 実際に 変! li する 必要の ある 部分は 

リス 卜 1-7 に 小した ドキュメント テン プレー 卜を 玆録 している 部分 だけです。 




CMultiDocTemplate* pDocTemplate ; 
pDocTemplate = new CMultiDocTemplate( 

IDR.TEXTEDITTYPE, // ここを 変更 

RUNTIME.CLASS(CTextEditDoc) , 

RUNTIME_CLASS(CChildFrame), // カスタム MDI 子 フレーム 
RUNTIME-CLASS (CEditView) ); //CTextEditView を CEditView に 変更 
AddDocTemplate (pDocTemplate) ; 



ii ) 名の 変 が* 済んだら、 ドキュメント テンプレート （ こ众鉍 される リソースを 編染 して、 
テキスト エディタに ふさわしい リソースに •丨 I ： き 換えます 

籲ス卜 リング テーブルの 編集 

まずは ストリング テーブルの 褊 恥から 始めましょう 。プロジェクト ワーク スペース ウィン 
ドウで [String Table] フ ォルダを ダブル クリックして ストリング テ一ブルリ ソースを 衣 示さ 
せて ください 。すると 1 つ だけ、 やはり [String Table] という 名前の ストリング テーブル リ 
ソースが 衣ボ される ので、 これを ダブル クリックして ください 。すると ストリング テーブル 




ストリング リソースの 内容 



図 1-9 ス卜 リング エディタ 

ェ ディ 夕が 起動され ます 。テーブルが 衣/ ji されたら、 その 中の [idr_textedittype] 

を ダブル クリックして ストリング ェディタを 開いて ください （図 1-9 し 

ストリング セグメント ： 0 には、 IDR_TEXTEDITTYPE が 小す 文 ••列が 穴 まれて いま 
す。 この 文 卞 列は 「 ¥n 」 によって K 切られて いる 7 つの フィールドから なって います （表 
1-6 )。 これらの フイ 一 ルドは II)K_TEXTED1TTYI)E のように、 いくつかの フィールド 
は 竹 略す る こと も" J * 能です。 ただし、 竹 略した 場 介には、 VT 略した フィールドに 応じて 機 
能が 制限され るので、 必要な フイ 一 ルドまで 竹 略してし まわない ように 注ぬ: が 必要です 0 



フィールド 名 


省略した 場合 


目的 | 


windowTitle 

晒 ■国 ■! 


空 文字列 


メインフレーム ウインドウの 
キャプション （ SDI アプリ ケー 
シ ヨンの み、 MDI アプリケーション 
では IDR _ MAINFRAME ストリング 

し 1 d _3 t ) 


docName 


Untitled 


ドキュメント ウィンドウの キャブ ショ 
% 


fileNewName 


[ファイル] 一 [新規 作成] コマンドで 
作成で きなくなる 


[新規 作成] ダイアログで 表示され る ド 
キュメ ン卜タ イブ 名 


filterName 


[ファイル] 一 [開く] コマンドで 開け 
なくなる 


[ファイルを 開く] ダイアログの [ファ 
イ ルの 種類] に 表示され るドキ ュメン 
卜 タイプ 名 


filterExt 




[ファイル] 一 [開く] コマンドで 開け 
なくなる 


ドキュメントを ファイルに 保存す ると 
きに 使う ファイル 名の 拡張 子 


regFileTypelD 


ファイル マネージャから デ一タフ ァ 
イ ルを 指定して 起動で きなくなる 


レジス トリに 登録す る ドキュメント タ 
イプ 名 （内部 管理 用） 


置 

regFileTypeName 


ファイル マネージャから データ ファ 
イ ルを 指定して 起動で きなくなる 


レジス トリに 登録す る ドキュメント タ 
イプ 名 （ダイアログ ボックス 表示 用） 



一 卜に 登録す るス卜 リング リソースの フォー • 
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SDI アプリケーションの 場 介には、 windowTitle フィ一ルドと docName フィールドに 
は、 かならず 適 肖な 文卞 列を, 没 定 して おくべき です。 そうでな いと、 ウィンドウの キャブ 
シ ョンに 何も 衣ボ され なくなって しまいます 。ただし、 MDI アプリケーションでは、 その 
必要は なく、 その代わりに IDR—MAINFRAME ストリング リソースに |nj じ II 的で 义卞列 
を 設定して おきます。 IDR—V1AINFRAME ストリング リソースは 极数の フィールドに 分浏 
されて はいません から、 中. に キャプションに 使う 文字列を •设宛 する だけで かまいません。 

fileNewName フィ 一 ルドと filterName フィールドと filterExt フィールドは、 极 数の ド 
キ ュメ ントタ イブを 扱う アプリケーションでは、 かならず 設定して ください。 そうでない 
と、 ダイアログ ボックスから 指定した ドキュメント タイプで ファイルを オープンしたり、 
新規に 作成で き なくなって しまいます 0 

regFileTypelD フィ 一 ルドと regFileTypeName フィ 一 ルドは、 エクスプローラで デー 
タフ ァイ ルを ダブル クリック する ことにより、 その データファイルの ファイル タイプに 閲 
迚付 けられた アプリケーションを 起# できる ようにす るのに 使われ ますが、 イく •丨丨 : では 利 川 
しません。 

ところで、 AppWizard が 十. 成した II)K-TKXTKI)ITTYI)K には 3 っの フィールド しか 
ありませんで したが、 A は filterName フィ 一 ルドと filterKxt フィールド も App Wizard 
で 役 定 する ことができます 〇 設 记す るには、 AppWizard の ステップ 4 にある く 詳細 設 宛〉 
ボタンを クリック すると 炎尔 される [•ぼ 細 •没) ヒ オプション] ダイアログ ボックスを 使い ま 
す。 ここで ドキュメントの 拡张 ，•を 设 记 する だけです 3 デフォルトでは 何も 設记 されて い 
ない ので、 ここでは 3 つし か フイ 一 ルドが 川 立 されて いなかった のです。 




図 1-10 AppWizard で ドキュメントの 拡張 子を 投定 する 



とりあえず、 iti 後の 2 つの フィールドは 竹 略して、 次のように II)R_TEXTEDITTYPK 
ストリング リソースを 変! li しまし よう。 このためには、 ストリング エディタで ii ) r_text 
EDITTYPE を ダブル クリックして 、褊恥 ウィンドウを 間き ます 9 こうして おけば、 あと 



1.8 リソースの _ 集 
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図 1-11 ス卜 リング リソースの 設定 

は フレームワークから 適丫丨 ••参照され て、 ウィンドウの キャプション や ダイアログ ボックス 
の アイテムが n 勋 的に 設定され ます 〇 

• メニューの 追加 

次に メニュー リソースの 褊災を 行います 。メニューの 利 川ん •法は 第 2 部で 説明し ました 
が、 ここでもう-度 簡丨 |1 •に 説明して おきましょう 0 

1. リソース エディタを 使って、 メニュー 拟丨丨 を 作成し、 II ) を* •別り、 丨 ，丨 てる 

2 . ClassWizard を 使って、 メニュー 识丨 丨に対 丨心 する メッセージ ハンドラを 作成す る 

3. メッセージ ハンドラを, k ! 述 する 

ここまでは、 メニュー 项丨丨 を迸択 したと きに 呼び出す ような 関数に ついて 柯 も芩 えてい 
ない ので、 メニューを 沿 加す る 列 丨丨丨 はない ように m える かもしれ ません c ところが、 火は 
CEditView クラスには 表 1-7 に/ ji すよう な [褊 災] メニューの 中で 使える 閲 数と オブジェ 
ク卜 II ) が あらかじめ 川 •〇: されて いるので す。 フレームワークの 屮 で メッセージ マップ も 
川 •なされて いるので、 必 災: な処 fl ! •は リソース エディタを 使って メニュー 拟丨丨 を 作り、 閲 数 
に 対応した 才ブジ ヱク卜 II ) を拟り 分ける だけです 3 これ だけで テキスト エディタに 必災: 
な 機能が そろって しまう のです。 



ジエク 卜 ID 
D.EDIT.CUT 
D.EDIT.COPY 
D.EDIT.PASTE 
D.EDIT.CLEAR 
D.EDIT.UNDO 



D.EDIT.SELECT.ALL 

D.EDIT.FIND 

D.EDIT.REPLACE 

D.EDIT.REPEAT 



メッセ ー 

OnEditCut 
OnEditCopy 
OnEditPaste 
OnEditClear 
OnEditUndo 
OnEditSelectAII 
OnEditFind 
OnEditReplace 
OnEditRepeat 



行う 処理 
iM 択 範囲の 切り取り 
選択 範囲の クリップ ボードへの コピー 
クリップ ボードの 内容の 貼り付け 
選択 範囲の 削除 
直前の 処理の やり直し 
すべての 範囲を 選択 
文字列の 検索 
文字列の 置換 

直前の 検索/置換の 繰り返し 



表 1-7 オブジェクト ID と 結び付けられた 操作 



卜 エディタを 作って みよう 



スのサ 一 ヒスを 使 



m 



t つに メニューを 書き換えて 、 CEditView 
図 中の 各 メニュー 項目に 割り当てる ID は 






ビー （ c ) 



削除 (D) 

文字列の 検索 (F) 
文字列の 置換 （ E) 
すべての 範囲を S 択 （ A) 



各 メニューに 対応す る 
ID は 表 1-8 を# 照 



D_EDIT.UNDO 

D.EDIT.REPEAT 

D_EDIT.CUT 

D.EDIT.COPY 

D.EDIT.PASTE 

D.EDIT.CLEAR 

D.EDIT.FIND 

D.EDIT.REPLACE 

D.EDIT.SELECT.ALL 



表 卜 8 メニュー 項目と その オブジェクト ID 



1.9 テキス 卜 エディタ 完成！ 



さあ、 これで テキスト エディタに 必要な 処理は すべて 終わりました 。さっそく コンパイ 
ル/ ^ 実行して みまし よう 。たった あれ だけの コードを 追加した だけの ものとは 恐えない ほ 
ど 高機能な マルチ ファイル テキスト エディタの 完成です。 

ここまでに 作成した プログラムの ソースコードは、 付铋 CD-ROM の 「MMView¥Stepl」 
フォルダに 格納され ています 0 

ひとまず 一区 切りが ついた ところで、 1 つネ夕 ばらしを してし まいましょう 。奥は 本* 
で 扱った 作業は、 ほとんど すべて App Wizard が やって くれる ことなの です。 










RR1C3 



战 小: クラス: 



も 追加して く 



ここまでで できた ブロ グラムの 実行 画面 

，イア ログ ボックスに、 ビュー クラスを 迸択 したと きに た 
J ンボ ボックスが ある ことに Z メ (がつ いた ノ / もい るか もしれ 
こよって、 CView クラス 以外の クラスを 店 成 クラスと して 
るので す。 さらに、 そこで 迸んだ クラスに 丨 え; じて ちょっと 
たとえば、 ここで CEditView クラスを 迸択 すれば、 先に 



;£! 加した 



6/6 



nc 



し ： p 一 

3^^ 一 w 了©] 4 t >«. 

[CTfwV^f v j| 



図 1-14 基底 クラスの 指定 



纂® クラスに 
[ CEdUV 丨 ew 】 を 说 択 



> の も 勉強のう ちと 納得して いただいて、 次 0 へ 説み 進んで ください 
の サポートは 多くを 期待で きない 部分です から、 ご 公 心く ださい。 









ドロー ツールを 

2 作って みよう 




前ウ の テキス 卜エデ ィタは \11)1 アプリケーション として 作成した ため、 丨„]丨 ゆに 极 数の 
テキス トフ ァイ ルを 衣尔 したり 褊姒 したりす る ことができました。 しかし MDI の 利 A は 
それだけではありません 0 |" J 時に 极 数の ドキュメント タイプを 扱う ことができ るの も Mr)I 
アブリ ケー シ ョンの 人き な 利 A です （図 2-1 >〇 

そこで、 小: ぐ c では 段 数の ドキュメント タイプが 扱える という MDI の 特徴を 生かして、 
MM\’iew に ドロー ツールを 沿 加して みます。 ドロー ツールとは、 •及: する に マウスを 使った 
簡中 •なお 絵描き ブロ グラムです 〇 この ブロ グラムを 作成す るには、 メッセージの ハン ドリ 
ングや GDI IW 数を 使った ウィンドウへの 丨ズ丨 形の 描丨由 | •などの 処 神が 必要になります 。また、 
メニュー や ダイアログ ボックスを 使って、 ペンの 人: さや 色を 選べる ように もします。 丨义丨 形 
データは ドキュメント クラスで 竹 那 •し、 シリアライズを 使った ファイル 入出力 も 行います 〇 
こうして みると 第 2 部で 扱った 卜 ビック や 第 3 部で 扱って きた Serialize 閲 数な ど 非常に 多 
くの 紫: ぶが たまれる ブロ グラムと なること が 想像で きます。 本 0 では、 いよいよ 4： 格 的な 




図 2-1 MDI アプリケーションで 複数の ドキュメント タイプを 使ろ 
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2 ド □一 ツールを 作って みよう 



プログラミングの 作 袋を 行う ことにな ります。 

余談になります が、 MFC では 1 つの ドキュメント タイプで 複数の ビューを 利 川す る こ 
ともで きます。 たとえば、 テキス 卜 エディタでは ドキュメント として テキストを 竹 邱 し、 
これを 义卞 列と して ビューに 衣氺 してい ますが、 そのほか にも 16 進数の ダンプ リストを 
ビューと して 炎 小す る こと もで きます。 これにつ いては、 第 4 部で 扱う ことにしましょう。 

费 

2.1 ド □一 ツールの 設計 

では、 鉍 初に 本 寧で 作成す る ドロ一ツールの 化 様を 決めましょう。 扱う 丨ズ丨 形は、 丨! •(線、 於 
か 形、 格 丨リ の 3 M 類です。 描 丨叫丨ズ 丨形の 選択は、 図 2-2 に 示す ような [间 形] メニューで 行い 
ます 0 

m (& 

矩形 (fi) 

很円 (£〉 



図 2-2 [図形] メニュー 

[ M 形] メニューから [め: 線] を 迸んだ 坳 介は、 マウスで 指定した 2 点を 丨 f 丨: 線で 結びます 0 
[从ガ 形] は マウスで 指 走した 2 点を 対角線と する 反ガ形 （相 形） を 描きます。 [格 旧] は 2 
点を 対/ 0 線と する 从ノゾ 形 （か: 形） に 内接す る 格 丨リ を 描きます （図 2-3)。 





V Elli: 



Point 1 




2 点を 結ぶ 直線 



2 点に より 定まる 矩形 



2 点に より 定まる 矩形に 
接する 楕円 



図 2-3 指定した 2 点の 位! ■と 描画 図形 （直線、 長方形、 楕円） の 関係 




2.1 ド □一 ツールの 設計 



また [丨义 丨形デ 一夕] メニューを 選択す ると、 図 2-4 のよう な ダイアログ ボックスが 開き、 
ペンの 人 さ、 ペンの 色、 および ブラシの 笆が 設定で きます， ここで 決めた ペンに よって、 丨 
線、 長方形の 枠、 楕円の 枠が 描丨由 i されます 。ブラシは 長方形と 楕 丨リ の 内部を 飨 りつぶ すの 
に 使います 。ただし、 [丨ズ丨 形 データの 設定] ダイアログ ボックスを 使 川しての 描丨由 i データの 
設记は DDX を侦 川して いる だけな ので、 本 0 では 触れません。 欠 際の コード や リソース 
について は、 付 铖 CD - ROM に 含まれて いる 「 MMView ¥ CompleteJ フォルダの 内容を 参 
照して ください。 
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図 2-4 [図形 データの 設定] ダイアログ ボックス 

描丨由 I した 丨ズ丨 形 デ 一夕の 保存と 説み 込みには、 [ファイル] メニューを 使用し ます。 [名前 
をつ けて 保存] や [丨 •.抑き 保存] を 選択す ると データが ファイルに 保稃 され、 [開く] を 選 
択 すると 保 介して おいた データを 説み 込んで 丨由 j 仙 に 衣, j ; •する ことができます （図 2-5 ) 。 
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図 2-5 [開く] ダイアログ ボックス 




264 _£ ド □一 ツールを 作つ てみ よう 



2.2 第 2 の ドキュメント タィプ 

では、 この ドロー ツールを MI)I ウィンドウの 中に どのように 衣 示 すれば よいので しょ 
うか？ その 鍵は AddDocTemplatelSt ] 数に あります 0 この 閲 数を 使って アプリケーション 
が 利 川す る ドキュメント テンプレートを％ 鉍 するとい うことは すでに 述べました。 つ まり、 
AddI ) ocTemplate |5 y 数を 使って、 新しく ドキュメント テンプレートを 众鉍 する わけです 
が、 そのためには ドロー データを 扱う ドキュメント クラスと ビュー クラスを 新たに 作成す 
る必 災: があります。 ケ 度は CEditView クラスの ような 使 利な クラスはありません。 分で 
妃 述 しなければ いけない のです。 

簡丨 I 1 •に AddDocTemplate 閲 数を 使えば よいと 述べました が、 そのために 必要な 処 神 は 
たくさんあります。 

1. リソースの 作成 

2. ドキュメント クラスと ビュー クラスの 作成 

3. ドキュメント ビューの 火 焚 

4. ドキュメント テンプレートへの 众鉍 

それでは 1 つ 1 つ# 備 をして いくこと にしましょう。 

2.3 IDR_DRAWTYPE リソースの 作成 

ドキュメント テン ブレー 卜を 新しく 作る ためには、 ドキュメント クラスと ビュー クラス 
の ほかに リソース も 必要です。 ドキュメント テンプレートに 赍鉍 される リソースは、 アイ 
コン メニュー ストリング リソース アクセ ラレータ テーブルの 4 M 頌 である ことは す 
でに 述べました。 しかし、 アクセ ラレータ テーブルは かならずしも 必贤 ではない ので、 こ 
こでは それ 以外の 3 M 類の リソースを 新しく 作る ことにしましょう。 ドロー データを 扱う 
ドキュメント タイプで すから、 リソース 名は [ IDK _ DRAWTYPE ] とします 

リソースを 新規に 作成す るには、 プロジェクト ワーク スペース ウィンドウに リソースの 
純 類が- 览衣ボ された 状態で、 新たに 作りたい リソースの 種類を 選択し ます。 そして 右ク 
リッ ク して シヨ 一 卜 カッ 卜 メニューを 衣, ji させる と、 [ …… の 仲人] という 拟|| が あるので 
これを 選択し ます。 たとえば アイコン リソースを 作りた ければ、 [ Icon ] を 選択した のち イ f 
クリックし、 ショ 一 卜 カッ 卜 メニュー にある [ I C0n の揷 人] を灾 行し ます 3 



2.3 IDR_DRAWTYPE リソースの 作成 



春 アイコン リソースの 作成 

Developer Studio には アイコン エディタが 焚備 されて いるので、 これを 使って アイコン 
作ります。 1 からすべ て アイコンを 作る のは なかなかたい へんです し、 それなりに センス 
が 要求され ます 。そんなと きには Windows に 付 W する アイコンを 利 川す るの も 1 つの 手 
です 〇 Developer Studio の [ファイル]- [開く] から EXE ファイル や DLL ファイルを 開 

くと、 その ファイルに 穴 まれて いる アイコン などの リソースを 収り 出す ことができます 
Windows フ オルダに ある Moricons . dl 丨 などには 通常 使われて いない アイコン リソースが 
禽 まれて いるので、 倘 人的に 利丨 U する プログラムで あれば、 こうした アイコンを 利 川す る 
の もよ いでし よう （図 2-6 >〇 リソース II) の 侦を明 小 的 (こ 指〉 ヒ したいと き （こは 「リソース 
II) 名 = リソース II) 侦」 の 形式で リソース II) を 指 走して ください。 



ショートカット メニューから kon の铎 入] を 
次択 して. アイコン リソース f ft 砟 




図 2-6 アイコンの 投定 



• メニュー リソースの 作成 

メニューは、 メニュー エディタを 使って 作ります が、 ドロー ツールで 必 •及: な メニューは、 
テキスト エデ イタの メニューと ほとんど 丨 じです そこで、 テキスト エディタの メニュー 
リソース、 「 IDR - TEXTEDITTYPE 」 から 必装な 坝丨 丨を コピーす るの が济 てっ とり 丨丨丨 •い 
方法です。 

まず アイコン リソースと 叫 じように ワーク スペース ウインドウから 新しく メニュー リ ソー 
スを 作ります 。次に テキスト エディタの メニュー （ IDR _ TEXTEDITTYI ) E ) を 開き、 作成し 
たばかりの メニューと 並べて 幽 •曲に 衣/ j ; •させて ください。 ここで idr_textedittype 

メニューの [ファイル： メニューを 「 Ctrl を 利丨 しながら ドラッグし、 1 I ) R_DKAWTYPK メ 
ニ ューの 丨 •.に ドロップ します。 すると： ファイル： メニューの すべての メニュー 项丨 丨 をコ 



一 ツールを 作って みよ 



できます。 または、 マゥスの イ, •ホ タンで ドラッグ & ドロップを しても かま い ません 
り 場合、 ドロップした 時点で ショ-卜 カット メニューが 細され るので、 [コピー] を 
します 。同じ 要領で、 [表示] メ ニ ュ 一と [ゥィン ドゥ] メ ニ ュ 一と [ヘルプ] メ ニ ュ_ 
ヒ-して ください。 紐に [曝] メニューを ■丨 すれば メこュ _は 完成し ます （図 2 _ 

— シヨ 一 卜 カット メニューから 

• [Menu の掸 入】 を* 択 



M £， 



テキスト エディタの メニ ユ一 

リ ソ一ス （IDR TEXTEDITTYPE 〉 
から [編*】 を 除く すべての 
メニューを コビ一 



ーを 追加 



スの 作成 



DRAWTYPE に 忘れずに 変更して ください。 ま 
I ) 名に ついては 表 2-1 のようにして おいてく だ 



Ac<«leva«cv 



， •二曹 一 ^ 

圃 



ID の投定 




2.3 IDFLDRAWTYPE リソースの 作成 



メニュー 項目 


ID 名 


直線 (い 1 


ID-STYLE 丄 INE 


矩形 （ R) 1 


ID.STYLE.RECTANGLE 


櫝円 （ E) | 


ID.STYLE.ELLIPSE 


図形 データ （ S) 


ID-STY し E_DATASET 



表 2-1 [ 図形 ] メニューの メニュー 項目の オブジェクト ID 



鲁ス卜 リング リソースの 作成 

ストリング リソースは 、ストリング エディタを 利 川して 作成し ます。 そのため にはまず 新 
しい ストリング リソースの ための 坳 所を 乍け なければ なりません 。今度は スト リン グリ ソー 
スを 新しく 作る のでは なく、 既# の ストリング リソース テーブルに 新しい エントリを ill 加す 
ると いう 作 袋を 行います。 ワーク スペース ウィンドウから [ St ring Table ] を ダブル クリック 
して、 ストリング エディタを 起動して ください 。ストリング テーブルが 1;9 いたら、 その 屮 から 
[11)1 し THXTIiDITTYPE ] を逍択 します 。そして: 丨 的扣 を押すか、ィ,，クリックしてショート 
かソ トメ ニューから [ストリングの 新規 作成] を灾 行し ます。 すると、 IDR_TEXTEDITTYPE 
リソースの ドに スペースが できる ので、 ここに II ) R _ DRAWTYPE ストリング リソースを 
設记 します （図 2-9>。 
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図 2-9 ス卜 リングの 投定 



以丨 ••で リソースの 作成は 終 r です。 次に、 これらの リソースを 利丨 u して ドロー データを 
符 观/ 衣氺 する ための ビュー クラスと ドキュメント クラスを 作成し ます。 




2.4 派生 クラスの 作成 



では 次に、 新しく ドキュメント クラスと ビュー クラスを 作る ことにし ましょう メニュー 

から [表示]- [ ClassWizard ] コマンドを 実行して、 ciassWizard を 起動して くださ ぃ 。派 

1 ••クラスを 中 成す るた めには、 ClassWizard のく クラスの 加〉 ボタンを 使ぃ ますこの 
ボタンを クリック すると ドロ ツブ ダウン メニューが 開く ので、 ここから [新規] を 選択し 
ます 。すると、 第 2 部で も 使 した： クラスの 新規 作成： ダイアログ ボックスが 開きます 
「クラス 名] に 新規に 作成す る クラスの 名 丨’丨 むを 指 土して、 その クラスの 丛攸 クラスは [丛+ 
クラス] に 衣 示される リス 卜から 選択し ます 




図 2-10 新規 クラスの 作成 



ClassWizard を 使えば、 約 50M 類 もの クラスから 接 底 クラスを 選んで （表 2 _ 2> 、派, |: 
クラスを 作る ことができます。 これらの クラスに 丼讪 している ことは、 メッセージ マップ 
を 持って いると いう ことです。 メッセ-ジマ ップを 持って い ると いう ことは、 これらの ク 
ラスは ClassWizard を 使っ て その メッセージ ハンドラを 竹 珲 する ことができ ると いう 、知 
です。 

ところで、 メッ セージ マッ ブの 符理を 行う 必要の ない クラスを 作る ので あれば、 c 丨 ass 
\\ izard を 使っ て 派生 クラスを 作る 必要はありません。 Gass Wizard を 使って 派生 クラス 
を 作る と、 軍なる クラスの 记在 だけでなく、 あとで メッセージ ハンドラを 竹 神す るた めに 
必要な メッ セージ マッ プや 、基底 クラスに 応じた 初期 設 走 コードな どが 沿 加され ますこ 
つした サー ヒスが あって こその ClassWizard なのです。 仮に CVievv クラスの 派 牛 •クラス 
を师 業で 作り、 メッセージ マップを 記述し なかった 場 含には、 たとえ CView クラスの 派 
生 クラスと いえ ども ClassWizard を 使った メッセージ ハンドラの 符理 はでき ない 山: に 注ぬ. 
をして ください。 



2.4 派生 クラスの 作成 



基底 クラス 


用途 


CDialog 


ダイアログ ボックス 


CDocument 


ドキュメント クラス 


CFormView 


ダイアログ ボックスの ような ビュー クラス 


CFrameWnd 


SDI アプリケーションの メインフレーム ウィンドウ 


CMDIChildWncJ 


MDI アプリケーションの 子 ウィンドウ 


CScrollView 


スクロール バーの ついた ビュー クラス 


CView 


汎用 的な ビュー クラス 


generic CWnd 


一般的な ウィンドウ 


splitter 


複数の 表示 領域を 持つ 子 ウィンドウ 



表 2-2 S 底 クラスに なりうる クラスの 一部 



ここでは、 CDocument クラスを 基底 クラスに した CDrawDoc クラスと、 CView クラ 
スを从 政 クラスに した CDrawView クラスを 作る ことにし ましょう。 クラス 名と その 浓贱 
クラス、 および クラスの 记 在を 記 还 する ファイルの ファイル 名は 表 2-3 のように 没 走す る 
ことにします。 



クラス 名 


基底 クラス 


インプリメント ファイル 


ヘッダ ファイル 


CDrawDoc 


CDocument 


DrawDoc.cpp 


DrawDoc.h 


CDrawView 


CView 


DrawView.cpp 


DrawView.h 



表 2-3 作成す る クラスの 投定 



必贤な 頊丨 丨を設 泣したら、 <0 K > ボタンを クリックして ください。 すると 指定した クラ 
スの记 在を 穴んだ ファイルが 作られます 0 

ClassWizard が 生成した コードには、 クラスの 走 在 だけでは なく、 ほとんどの 場合 オー 
バーラ イドす る 必要が ある 仮想 間数が あらかじめ ⑴总 されて います。 たとえば、 CView ク 
ラスの 派 卞 クラスには OnDraw 閲 数が、 CDocument クラスの 派 牛 クラスには Serialize 
閲 数が それぞれ ;|丨总 されます 。これら 以外の 接 底 クラスを 選んだ 場合には、 やはり それ ぞ 
れの クラスで 必要になる 仮想 間数が 用总 されます。 





2 ド □一 ツールを 作って; k 上 a 




2. D ヒューと ドキュメントの 実装 

派生 クラスの 作成が 終わりました から、 これからは ドキュメント クラスと ビュー クラス 
の® に 胸ます。 ドキュメント クラスでは 晴 データを 似け る クラスの 賊 などを、 
ヒ ュ- クラスでは クライ アン 卜猶 への ュ- ザ— の マウスの 人力を 如 fj .けたり、 描く 叫 
形を メニュー によって 选択 できる ようにし ます 

まずは ドキュメント クラスの 火災から 始める ことにし ましょう 

鲁 図形 データを 管理す る 

この ドロー ツールで 扱う 丨ズ丨 形 （政 線、 M "形、 格 円） は 図 2 3 にも 示しました が、 どれ 
も 2 点を 指记 する だけで その 位 i? {と サイズが 決まります 。したがって、 以 ドの 6 っ の パラ 
メータを 川 意 すれば、 丨? 丨 形に 関する すべての 要求を 衣せ ます 

春 図形の 種類 （直線/長方形/楕円） 

參 ペンの 太 さ 
♦ペンの 色 

♦ブラシの 色 （直線を 描画す る 場合は 無視す る） 

* 第 1 の 点の 座標 
♦第 2 の 点の 座標 



そこで リス 卜 2-1 に/ ji すよう な cShape クラスを 化 及して 丨ズ丨 形 データを 竹 列! する こと 
にし ましょう 。また 丨ズ丨 形の 械 類を 衣す ために、 STYLE 型 という データ 期 も宣忖 します 
STYLE 塑 は、 Line Rect Elli の 3 つの M のい ずれ かを 取る 列； ゆです 

I’ ズ I 形の パラメータは、 m _ sty l e から m _ p〇int2 までの 6 つの プライベートな メンバ 変数 

で 炎し ます。 ブライべ-卜な メンバとは、 その メンバが w する クラスの メンバから しか ア 

ク セス じきない メンバの ことです （•議 は A ppen di x 八 を擁 {)〇 この 場れ は、 CShape ク 

フスの メンバ 間数し か これらの メンバ 変数の 侦を変 セしたり、 その 侦を 説み 取る ことが で 
きないの です。 

ただし、 「friend c 丨 ass CDrawDoc :」 という 茛 ゴ があります から、 CDrawD〇c クラス だ 
けは 例外的に CShape クラスの プライベート メンバに も アクセス する ことができます、 
れ は、 CDravvDoc クラス 内で データを •以讨 るた めに CShape クラスを 利 川す るので、 プ 
ライべ-トメ ンバ にも アクセス できる と柯 かと 都 介の いい ことがある からです。 このよう 
な 場 •介、 CI)ra\vDoc クラスを 「CShape クラスの フレンド クラス」 といい ます ドキ ユメン 
卜 クラス 内で 竹 W る デ-タに ついて 1，1 分で クラスを 賊 するとき には、 ドキュメント ク 
ラスを その クラスの フレンド クラス にしておくと いいこと が 結構あります から、 觉 えてお 



2.5 ビューと ドキュメントの 実装 



いてく ださい 〇 CShape クラスの メンバ 問 数は メンバ 変数の 侦を 返したり、 引数に 指定 さ 
れた侦 を メンバ 変数に 代人した りする だけの ものです から、 クラス 走 衣の 中に メンバ 閲数 
の 定義を 商 接 含めて しまう ことにします。 



リス 卜 2-1 CShape クラスの 定義 （ DrawDoc.h) 



11111111111111111111111111111111111111 

// 列孪型 STYLE 



enum STYLE { Line, Rect, Elli }; 

11111111111111111111111111111111111111 

// CShape クラス 



class CShape 

{ 

friend class CDrawDoc; 



// フレンド クラスの 宣言 




STYLE 




COLORREF 




OLORRE! 

Point 



CPoint 



m.style; 
m.penwidth; 
m.pencolor ; 
m.brushcolor 
m.pointl ; 
m.point2; 



✓/0 形の 相 [類 
"ペンの 太 さ 
// ペンの 色 
"ブラシの 色 
" 第 1 の 点の 座摞 
" 第 2 の 点の 座摞 



public : 
void 


SetStyle (STYLE s) 


void 


SetPenWidth(int w) 


void 


SetPenColor (COLORR 
SetBrushColor (COLO 


void 


void 


SetPoint 1 (CPoint p 


void 


SetPoint2 (CPoint p 


STYLE 


GetStyleO 


int 


GetPenWidthO 


COLORREF GetPenColor ( ) 


COLORREF GetBrushColor ( ) 


CPoint 


GetPointlO 


CPoint 


GetPoint2() 


>； 





i = s; } 

i m.penwidth = w; , 
c) { m.pencolor = c; , 
:F c) { m.brushcolor = c 
{ m.pointl = pt; } 
{ m.point2 = pt; } 



{ return 
{ return 
{ return 
{ return 
{ return 
{ return 



m-style; > 
m.penwidth; } 
m.pencolor ; } 
m.brushcolor ; 
m.pointl ; } 
m.point2; } 




CShape クラスの ように ブロ グラマが まったく 新規に クラスを 定在 する 場 介には、 ClassW 
izard の 助力は 仰げません 〇 つまり クラス 定 在の コードは 全部 0 分の r •で 人力す る必 装が 
あると いう ことです 〇 CShape クラスは ドキュメント クラス 内で 利用す る ものです から、 
DrawDoc.h の 中で 定義 すれば よいで しょう 。リス 卜 2-1 に/ した コードは DrawDoch ファ 
イ ルの CDrawDoc クラスの 走 在の 直前に 揷 人して ください 。ヘッダ ファイル （DrawDoc.h) 



2 ド □一 ツールを 作って みよう 




を I 汗 K U ± 、ワーク スペース ウインドウの [ classView ] ページで [ CDrawD〇c ] を ダブル 
クリック します。 

次に、 CShape クラスを ドキュメント クラス ci ) raw D 〇 c の 中に 組み込み ますと ぃって 
もたいし J しい 作れ、 はなく、 リス 卜 2-2 の アミが かかった 部分の ように ci ) rawI)oc 
ク フスに CShape クラスの メンバ 変数を 1 つ 川, な し、 その メンバ 変数を 操作す る 一 迚のメ 
ンバ丨 划 数を 沿 在す る だけです。 



リス 卜 2-2 CDrawD oc クラスに メンハ 玉 数と メンバ 関数を 勤 D(DrawDon h) 

class CDrawDoc ： public CDocument 
て 

protected: 

CDrawDoc (); // 動的 生成に 使用され る プロテクト コンストラクタ 

//アトリビュート 

public: 

CShape m.shape; // 現在 描画 中の 図形を 表す 



{ m_shape.SetStyle(s) ; > 

{ m.shape.SetPenWidth(w) ; > 

{ m_shape.SetPenColor(c); > 
c) { m_shape.SetBrushColor(c) ; > 



void SetStyle (STYLE s) 
void SetPenWidth(int w) 
void SetPenColor(COLORREF c) 
void SetBrushColor (COLORREF 
void SetPointKCPoint pt) 

void SetPoint2(CPoint pt) 

STYLE GetStyleO 
int GetPenWidthO 
COLORREF GetPenColor ( ) 

COLORREF GetBrushColor () 

CPoint GetPointlO 
CPoint GetPoint2() 

//インプリメンテーション 

protected: 

virtual -CDrawDoc (); 

• ••略 



{ m_shape.SetPointl(pt); > 

{ m_shape.SetPoint2(pt); > 

{ return m.shape .GetStyleO ; > 

{ return m.shape .GetPenWidthO ; > 

{ return m.shape .GetPenColorO ; } 

{ return m.shape .GetBrushColor () ; > 
{ return m.shape. GetPoint 1 () ; > 

{ return m.shape .GetPoint2() ; } 



CDrawDoc クラスの コンストラクタの 定義 

これで、 丨’ズ丨 形 データを 処押 •する ための, 備が できました。 が、 このままでは ドキ ュメン 
トクラスの オブジェクトが 作成され た丨 紐の 状 ぐ紋 です。 _ を 描く のか？ ペンの 
色 や 人 さは？ フランの 色は？ といった 要ぶ が 何も 決まって いません。 そこで、 ドキ ュメン 
トク フスの コンストラクタ （ CI ) rawDoc :: CDrawD 〇 c 閲 数） で これらの 初期設定を 行って し 
まつ 一とに しまし よう。 もちろん、 CShape クラスの コンストラクタを 利〗 | 1 しても か 幸い 
ません が、 N 形 データの 初期化が 必要な のは、 新しい ドキュメントを 作る とき だけな ので、 



2.5 ビューと ドキュメントの 実装 



イく プログラムでは CI)rawI)oc クラスの コンストラクタで 初期設定を 行う ことにしました 0 
コンストラクタの リストは リス 卜 2-3 に/ ji します。 

リス 卜 2-3 CDrawDoc::CDrawDoc 関数 （ DrawDoc.cpp) 

CDrawDoc: :CDrawDoc() 

{ 

m_shape . SetStyle (Line) ; // 初 其 月 設定では 直線を 描く 

m.shape . SetPenWidth(3) ; // ペン 幅は 3 

m.shape . SetPenColor (RGB (0 ,0,0)); // ペンの 色は 黒 

reshape . SetBrushColor (RGB (255 , 255 , 255) );// ブラシの 色は 白 



ここで 設定され た N 形 データの うち、 描く 丨ズ丨 形の 神: 類は [ぼ 丨 形] メニューから [直線]、 
[ル: 形]、 [格 N] のれ メニュー 拟丨丨 を 選択して、 その他の データは [M 形 データ] メニューで 
衣 小され る [ペンと ブラシの 设记] ダイアログ ボックスを 使って 変史 する ことができます 0 

[ペンと ブラシの •没 定] ダイアログ ボックスでは、 戈 際には DL)X を 利 川して、 ダイア ロ 
グ ボックスでの ューザーの 選択を CShape クラスの メンバ 変数、 m_shape の 各 メンバに 妃 
位させて いる だけです。 ダイアログ ボックスを 作成して クラスを 分鉍 し、 DDX 変数を 作成 
する r •.順は 第 2 部の 说 明の 繰り返しになる ので、 ここでは 行いません 。灾際 に、 どんな こ 
とを している かは、 先 ほど も いったよ うに 付 W CD-ROM の 「MMView¥Complete」 フ才 
ル ダに 収められ ている プログラム リストを 参芩 にして ください。 

したがって、 ここまでの 説明 どおりに MMView を 作成した だけでは、 [ペンと ブラシ 
の設 记] ダイアログ ボックスを 利⑴ しての 丨句 形の 描丨由 i スタイルの 変更は 行えません から 気 
をっ けて ください。 

♦ビュー クラスの 実装 

次に ビュー クラスの 火 焚を 行います 。先 焚の 多くは ューザーの クライアント 領域/ メ 
ニューを 使った 操作に 対応す る メッセージ ハンドラの 作成です 。そこで、 まず 凶 形ス タイ 
ルを 指定す る [丨 ••丨 : 線]、 [U 力 •形]、 [格 丨リ] の 3 っの メニュー コマンドに 対して メッセージ 
ハンドラを 作成し ます （リス 卜 2-4) 0 CDrawView クラスの オブジェクトは、 これらの ハ 
ン ドラを 火む する ことによって、 「丨 分の ドキュメントの 屮に 含まれる 描丨由 j スタイルの 設定 
を 変 1 上します。 

MDI アプリケーションでは 、メニューからの メッセージは、 その 時 A で アクティブな 子 
ウィンドウに 送られます） したがって、 CDrawView クラスの ウィンドウが 複数 表示され 
ていても、 メニュー によって 描 丨丨 hj スタイルが 変更され るのは、 アクティブな ウィンドウが 
している ドキュメント （とその ドキュメントに 問 速 付けられ ている ビュー） にっいての 
みに 限られる ことに 注 立して ください。 



CDrawView 

CDrawView 



ID-STYLE 丄 INE 
USTYLE-RECTANGLE 



CDrawView ID.STYLE.ELLIPSE 



ッ セージ 

COMMAND 

COMMAND 

COMMAND 



表 2-4 描画 スタイルを 変更す る メッセージ 八ン ドラ 
描画 スタイル 変更 用 メッセージ 八ン ドラの 実装 （ DrawView cpp ) 



void CDrawView: :OnStyleLine() 

{ 

GGtDocument()->S©tStyle(Line) ; // 描画 スタイルを Line にす る 



OnStyleLine 

OnStyleRectangle 

OnStyleEllipse 



void CDrawView: : OnStyleRectangle () 
GetDocument()->SetStyle(Rect) ; // 描画 スタイルを Rect にす る 



void CDrawView: : OnStyleEllipse () 
GetDocument()->SetStyle(Elli) ; // 描画 スタイルを Elli にす る 



また、 
を 付ける 
します。 




一のう ち、 現在 選択され ている 描 肉 • スタ • 

に > ji す UPI ) ATE _ COMMAND_UI メッ- 

ラの 指记は 表 2-5 を 参考に してく ださい。 










ツク マークを 付ける メッセージ 八ン ドラ 



OnUpdateStyleLine 

_ ■_ — 

OnUpdateStyleRectangle 



OnUpdateStyleEllipse 



UPDATE-COMMAND 



ジ の八ン ドラ （ DrawView.cpp) 



void CDrawView: :OnUpdateStyleLine(CCmdUI* pCmdUI) 
pCmdUI->SetCheck(GetDocument()->GetStvle() == Line、. 



void CDrawView: : OnUpdateStyleRectangle (CCmdUI* pCmdUI) 





2.5 ビューと ドキ ュメン 卜の 実装 



pCmdUI->SetCheck(GetDocument()->GetStyle() == Rect) ; 

> 

void CDrawView: :OnUpdateStyleEllipse(CCmdUI* pCmdUI) 

{ 

pCmdUI->SetCheck(GetDocument ()->GetStyle() == Elli) ; 



U)ra\vView クラスの クライ アン 卜 m 域で マウスが 操作され た垛 合は、 リスト 2-6 にポす 
3 つの メッセージ ハンドラ 力 卿び 出されて、 丨丨丨 丨丨面 に |对 形を 衣 示します 。ここでは、 OnDraw 間 
数を 使わずに、 0 丨 iMouseMove 問 数と OnLButtonUp 関 数の 屮で闻 形の 描 丨由 i をして います。 
このように、 すべてを OnDrawliiJ 数で まかなわずに、 それぞれの ルーチンで C\Vnd::GetDC 
間数を 使って デバイス コンテキストを 取得して 丨由 iiW への 描丨由 i を 行う こと も 可能です 0 
マウスの ノ ボタンが 押される と、 M 形の 始 A が 決) u し、 その あと ボタンが 離される まで 
OnMouseMove 閲 数の 中で 丨ズ丨 形の 始乂丨 : から マウス カーソルまで どんな 丨女丨 形になる のかを 知 
ら せる ために ダミーの 丨ズ丨 形が 描丨叫 されます， このと きに、 XOK の マスクを 利 川して、 丨 
前の OnMouseMove 閲 数で 描いた ダミーの M 形を 消丄 •している ことに 注总 してく ださい。 
マウスの“ ボタンが 離される と、 M 形の 終点 も 決 逛 し、 肉 丨『丨丨 •に M 形が 描陶 •されます。 



クラス 名 オブジェクト ID メッセージ メッセージ ハンドラ 

CDrawView なし （ CDrawView を S 択） WM-LBUTTONDOWN OnLButtonDown 

CDrawView なし CDrawView を iM 択） WM-MOUSEMOVE OnMouseMove 

CDrawView なし （CDrawView を 選択） WM-LBUTTONUP OnLButtonUp 



表 2-6 メッセージ ハンドラの 指定 



リスト 2-6 図形を 描画す るた めの メッセージ ハンドラ （ DrawView.cpp) 

void CDrawView: : OnLButtonDown (UINT nFlags, CPoint point) 

{ 

CDrawDoc* pDoc = GetDocument () ; 

pDoc->SetPointl (point) ; 
pDoc->SetPoint2(point) ; 

SetCaptureO ; // マウスの キャプチャーを 開始 



void CDrawView: : OnMouseMove (UINT nFlags, CPoint point) 



2 ドロー ツールを 作-) T みよら 




CDrawDoc* pDoc = GetDocument () ; 

CDC* pDC; 

CPen dashPen(PS_DASH, 1, RGB (255, 255, 255)); 

CPen* pOldPen; 

CPoint ptl = pDoc->GetPointl() ; 

CPoint pt2 = pDoc->GetPoint2() ; 

if (IGetCaptureO) // マウスが キャプチャーされ ていないなら （マウス 
return ; // ボタンが 押されて いないなら） 何もし ない 

pDC = GetDCO; 
pDC->SotR0P2<R2_X0RPEN ) \ 
pDC->SelectStockOb j ect (NULL.BRUSH) ; 
pOldPen = pDC->SelectObject(&dashPen) 

switch (pDoc->GetStyle 〇 ) { 
case Line: 

pDC->MoveTo(ptl); // 直前に 引いた 直線の 始 点に 移動して、 もう 一度 同じ 
pDC->LineTo(pt2) ; // fi 線を 引く と XOR の マスクの ために その 線が 消える 

pDC->MoveTo(ptl); // 再び 直線の 始 点に 移動して 
pDC->LineTo (point) ; // マウス 力一ソルの 位 * まで 直線を 引く 
break; 
case Rect: 

pDC->Rectangle(ptl.x, ptl.y, pt2.x, pt2.y); // 面 前に 描いた 矩形の 消去 

pDC->Rectangle (ptl . x , ptl. y, point . X ， point.y); // 矩形の 描画 
break; 

case Elli: 

pDC->Ellipse(ptl.x, ptl.y, pt2.x, pt2.y); // 直 前に 描いた 櫝 円の 消去 

pDC->Ellipse(ptl.x, ptl.y, point. x, point. y); // 悄 円の 描画 

break; 

> 

pDoc->SetPoint2(point) ; // 現在の マウス 力-ソル 位 臞 を 記憶 
pDC->SGlectObject (pOldPen) ; 

ReleaseDC(pDC); // デバイス コンテ キス 卜の 解放 



"テ バイス コンテ キス 卜の 取得 
//XOR の マ スフを かける 
か ヌル ブラシを a 択 
;// ダッシュ ペンを 選択 



void CDrawView: :OnLButtonUp(UINT nFlags, CPoint point) 

CDrawDoc* pDoc = GetDocument () ; 

CDC* pDC; 

CPen dashPen(PS-DASH, 1, RGB(255, 255, 255)); 

CPen drawPen(PS.INSIDEFRAME, pDoc->GetPenWidth() , pDoc->GetPenColor() ) ; 
CPen* pOldPen; ' 

CBrush Brush (pDoc->GetBrushColor ( ) ) ; 

CPoint ptl = pDoc->GetPointl() ; 

CPoint pt2 = pDoc->GetPoint2() ; 

pDC = GetDCO; // デバイス コンテ キス 卜の 取得 
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pDC->SetR0P2(R2.X0RPEN) ; //XOR の マスク 

pDC->SelectSt ockOb j ect (NULL.BRUSH) ; 
pOldPen = pDC->SelectObiect (&dashPen) ; 



switch (pDoc->GetStyle 〇 ) { 
case Line: 

pDC->MoveTo(ptl) ; 
pDC->LineTo(pt2) ; 
pDC->SelectObject (&drawPen) ; 
pDC->SetR0P2(R2.C0FYPEN) ; 
pDC->MoveTo(pt 1) ; 
pDC->LineTo (point) ; 
break; 
case Rect: 



// 直線の 消去 



"描画 用 ペンを 選択 
// 直線の 色は ペンの 色 
"直線の 描画 



pDC->Rectangle(ptl.x, ptl.y, pt 2 .x, pt 2 .y); // 矩形の 消去 
pDC->SelectObject(&Brush) ; // 描画 用 ブラシの iM 択 

pDC->SelectObject(&drawPen) ; // 描画 用 ペンの 選択 

pDC->SetR0P2(R2.C0PYPEN) ; // 枠線の 色は ペンの 色 

pDC->Rectangle(ptl.x, ptl.y, point .x, point. y); // 矩形の 描画 
break; 
case Elli: 

pDC->Ellipse(ptl.x, ptl.y, pt2.x, pt2.y ); "悄 円の 消去 
pDC->SelectObject(&Brush) ; // 描画 用 ブラシの iM 択 

pDC->SelectObject(&drawPen) ; // 描画 用 ペンの 選択 

pDC->SetR0P2(R2_C0PYPEN) ; // 枠線の 色は ペンの 色 

pDC->Ellipse(ptl.x, ptl.y, point.x, point.y); //相 円の 描画 
break; 



pDC->Select0bject(p01dPen) ; 
ReleaseDC(pDC) ; // テ バイス コンテ キス 卜の 解放 

ReleaseCaptureO ; // マウスの キャプチャーの 終了 



』 CDrawView::GetDocument 関数の 定義 

今までの 間数 中で CDrawDoc クラスの 才 ブジェク 卜を 得る ために f, 丨 j% なく 使って ぃた 
GetDocument 閲 数です が、 CDrawView クラスでは ブロ グラマが この 閲 数を 州 意し なけ 
れ ばいけ ません。 



App Wizard で スケルトンを 作成す る 場 介は、 ドキュメント クラスと ビュー クラスは ペア 
となる ことを 前提と して 作られる ため、 IAjTJ •の閲 係を 反映す るよう な コードが/ 丨: 成され ま 
した。 しかし CDraw View クラスと CDrawDoc クラスは、 それぞれ 個別に ClassWizard 
で 作つ た クラスです 。この場合、 ClassWizard は CDrawView クラスと CDrawDoc クラ 
スが 対応して いる ことを 知らないので、 両者に かかわる GetDocument _ 数は 生成で きな 
いのです。 
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そこで、 CDrawView クラスに も、 リスト 2-7 のよう な GetDocument 関数を 追加し ま 

す 。ある クラスに メンバ 閲 数 や メンバ 変数を 追加す る 場 •介には、 ワーク スペース ウィンド 
ウの [ClassView: ページで 、対象と なる クラスを イ丨 •クリックし、 ショートカット メニュー 
から [メンバ 関数の ifi 加] あるいは [メンバ 変数の 追加] を 選択す ると 簡丨 ji . です。 とくに、 
このん •法で メンバ 閲钕を Mi 人した 坳 介、 记義 ファイル （上 ファイル） と 火 焚 ファイル （ cpp 
フ ァイ ル） の丨山 jf ; •に対して 変 IJi がな される ので、 ブロ グラマの 卩を炽 わせる ことが ありま 
せん。 

ここでは、 図 2-11 に，』; •すよう に [関数の 胡 ] には [CDrawDoc*] を、 [関数の: iLi] に 
は [GetDocimient ( )] を 指) U して <() K > ボタンを クリック します このと き、 [アクセス 
制御 ] は [pub 丨 ic] のま ま、 [static] と [virtua 丨] も チェックを する 必要はありません。 無論、 
也 加したり 才ー バーラ イドす る閲 数に 応じて、 これらは 適 介 •指定す る 必要が あります。 閲 
数を 迨加 したら、 リスト 2-7 に 小す コードを 紀 述 してく ださい。 

1 •シヨ 一 卜 カット メニューから [メンバ 間数の 追加】 を 逍 択 
一 2 •このように 投定 する 



図 2-11 [メンバ M 数の 追加] ダイアログ ボックス 





リス 卜 2-7 CDrawView :: GetDocument 関数の 実 g ( DrawView . cpp ) 
CDrawDoc* CDrawView: :GetDocument () 

return (CDrawDoc*)m - pDocument ; 



なお、 DrawView.cpp の 先頭で DrawDoc.h を インクルードす るのを 忘れないで くださ 

い （リスト 2-8>〇 






卜の 実装 



// DrawView.cpp : 1 
// 

# include _• stdaf x • h •• 
#include "MMView.h" 
#include M DrawDoc.h 
#include M DrawView. 




リス 卜 2-7 を U ると、 GetDocument 閲 数は CDrawView クラスの メンバ 変数 m_pDocu 
ment を 返す だけと いう 非货に 中. 純な 問 数です 3 なぜ それだけ のために 問 数が 必要な ので 
しよう？ なぜかと いえば、 m _ pDocument の^! が CDocument クラスへの ボ インタ （CDocu 
ment * 喂） だからです。 たとえば、 CDrawView クラスで GetDocument 閲 数を 使う と、 
CDrawDoc クラスへの ポインタが 手に入ります。 しかし、 そうは せずにめ: 接 m_pDocument 
を 参照す るなら、 参照の たびに m _ pDocument をい ちいち CDrawDoc * M に キャ ストし な 
ければ なりません。 派 叱 クラスの オブジェクトを 店 嵌 クラスの オブジェクトに 代人す ると 
きには キャストは 必要ありません が、 逆の 坳介 はかならず キャス 卜が 必炎 だからです。 こ 
の丨 〖丨丨' 倒な 作衮 をせ ずに 济む ように、 派卞 クラスへの ポインタに あらかじめ キャ ストした 侦 
を 返す Get Document 問 数が 使われる のです 0 

•コードを 記述す る位匾 

lii •後に、 「// アトリビュート」 や 「// オペレーション」 といった ClassWizard が 成し 
た コメント について 説明して おき ましょう 。これらは しょせん コメントで すから、 無悦し 
て 適、 1 1 な 位 时 に メンバを; £1 加しても コードに 彩郛は 〇 ••えません が、 MFC の ソースコード 
はこの コメントに 応じて メンバの 位 的を 決めて いるので、 プログラマが 作成した クラスで 
も 從って おくと よいで しょう 。もっとも、 义際 には これ 以外に 分類され る メンバが いくら 
でも 必袈 になる はずです から、 ブロ グラマが 適切な コメントを 付ければ、 それが 説み やす 
い ソース リストに つながります 。表 2-7 に AppWizard や ClassWizard が 叱 成す るコメ 
ント とその |丨 的を 示して おきます 0 



コメン 卜 


主な 利用 目的 








メンバ 変数 や、 メンバ 変数への 代入/参照に 利用す る 関数 




メンバ 変数を 使って 何ら かの 操作を 行う 関数 




基底 クラスの 仮想 関数を オーバーライドした 関数 



表 2-7 コメン 卜の 意味 
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2-6 ドキ ュメ ン卜 テン プレー 卜の 登録 

これで リソース ドキュメント クラス ビュー クラスと いう ドキュメント タイプを 憐 
成す る 部品の 川总が 終わりました （フレーム ウィンドウは MFC が 提供す る CMDIChild 
Wnd クラスを 利 川す る）。 あとは これらを まとめて ドキュメント テンプレートを テン プ 
レート リストに 众鉍 する だけです。 これは M も 難: しい ことはありません 。以 ドの 行を CM 

MViewApp::InitInstance 関数に 付け加える だけです （リス 卜 2-9>〇 

リス 卜 2-9 ドキュメント テン プレー 卜の 登録 （MMView.cpp) 



BOOL CMmviewApp: : InitlnstanceO 

{ 

…略 

CMultiDocTemplate* pDocTemplate; 
pDocTemplate = new CMultiDocTemplate( 

IDR.TEXTEDITTYPE, 

RUNTIME-CLASS (CTextEditDoc) , 

RUNTIME_CLASS(CChildFrame), // カスタム MDI 子 フレーム 
RUNTIME-CLASS (CEditView) ) ; 

AddDocTemplate (pDocTemplate) ; 

pDocTemplate = new CMultiDocTemplate ( 

IDR.DRAWTYPE, 

RUNTIME.CLASS(CDrawDoc) , 

RUNTIME-CLASS (CMDIChildWnd) , 

RUNTIME.CLASS(CDrawView)) ; 

AddDocTemplate (pDocTemplate) ; 

// メイン MDI フ レ一ムウ イン ドウを 作成し ます。 

CMainFrame* pMainFrame = new CMainFrame; 

…略 



Ai •後に、 リス 卜 2-10 のように MMView.cpp に DrawDoc.h と DrawView.h を インク 

ルードし ます。 これで、 とりあえず プログラムが 動く ようにな りました。 さっそく コンパ 
イ ル/ 灾 行して みましょう （図 2-12)。 
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リス 卜 2-10 2 つの ファイルの インク〗 U - ド （ MMView . cpp ) 

// MMView.cpp : アプリケーション 用 クラスの 機能 定義を 行います 

// 

#include "stdafx.h" 

#include "MMView.h" 

#include "MainFrm.h" 

#include "TextEditDoc .h" 

#include "TextEditView .h" 

#include "DrawDoc.h" //DrawDoc.h の インク ル-ド 
#include "DrawView.h" //DrawView.h の インク ル-ド 




図 2-12 実行 画面 



2.7 描いた 図形の 保存 

これでよ うやく 丨| 丨丨 ii 〖丨丨 •に 丨ズ丨 形を 描く ことができる ようになりました 。とはいえ、 今のと こ 
ろ ゥィンドゥを W 小 化する と 描いた 丨ズ丨 形が 消えて しまったり、 データを ファイルに 保存で 
きなかった りと、 ちょ っと敉 しいと ころがあります， 

これは 両 Ifij 描画を OnMouseMove 関数と OnLButtonUp 閲数 だけで 行い、 ゥィン ドゥ 

の W 描 丨由丨 •のこと を芩 えて いないと ころに 問題が あります。 ゥィンドゥの 内 描 丨山丨 •をす る 際に 
は OnDraw 関数が かならず 呼ばれる ことを 考える と、 描いた 闵 形を 洱描両 する コードを 
OnDraw 関数に 記述す る 必要が あるで しょう。 また、 直前に 描いた 図形 以外の 図形 デ 一夕 
を 保# していな いこと も 問題です 0 このままでは、 仮に 内 描丨由 j する コードを 記述して もた っ 
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た 1 つの 丨ズ丨 形し か丨丨 J： 描 丨叫 できません。 本節では、 ドキュメント クラスを 拡张 して、 この辺 
りを 改芮 する ことにしましょう 。そのために、 描いた M 形の データを すべて 保存す る こと 
にします。 また、 ファイルの 人出 人! を 行うた めに、 ドキュメント クラスに Serialize 1551 数を 
灾焚 します。 そして iti 後に、 本節で もっとも 取 要な トピック である、 ドキュメント クラス 
以外の クラスに Serialize 関数を 货装 する 方法に ついて 解説し ます 0 



春 リス 卜を 使って 図形 データを 保存す る 

まずは、 あとで I 丨 描 肉したり ファイルに 保存す るた めに、 M 形 データを すべて 取って お 
くこと から 始め ましよう 。今のところ 、ドキュメント クラスには 1 つ だけし か CShape ク 
ラスの オブジェクトを 保む: していな いので、 複数の データを 保む: できる ように 変 史 する 必 
•挺が あります 。そのためには fli! 列を 使う のが もっとも 簡中 •です が、 それでは 保存で きる 図 
形の 数に 糾则 がで きて しまいます 。これは っまらない 制 陨 ですから、 避けたい ところです。 
そこで ここでは IV 列の 代わりに、 MFC が 提供して いる CObList クラスを 使って、 リスト 
惝 造で データを 竹 押. する ことにしましょう （図 2-13>。 



^rL^r=> 

要 索 2 要 索 3 ウィンドウ 

^ ^ に 描画 

図形 データの リス 卜 と 見スる 

図 2-13 リス 卜で 図形 データを 管理す る 

リスト 惝 造とは、 •&: ぶ 数が"] •変の 妃 列と 芩え ておけ ばよ いでしょう 。リス 卜を 使う と、 
CShape クラスの 才 ブジェク 卜を ゼ 、炎な 数 だけ fffl! できる ので、 fid 列の ように 必要 以 | •.に 
贤 ぶを あらかじめ 確保して おいたり、 要ぶ が 足り なくなったら それまで という こと も あり 
ません 〇 MFC が 提供す る CObList クラスを 使えば、 この リスト 構造を 簡琳 に 扱う ことが 
できます 〇 CObList クラスの メンバ 丨阳 数のう ち、 + ブロ グラムで 利 J|j する ものを 表 2-8 に 
あげて おきます。 



〇 

要素 1 




メンバ 関数 


機能 


GetHeadPosition 


先頭の 要素の 位* を 返す 


GetNext 

- ■ — ■ ■■睡 1 


次の 要素の 位 » を 返す 


AddTail 


リス 卜の 末尾に 要素を 追加す る 


H 

RemoveAll 


すべての 要 索を 削除す る 


GetCount 


要素の 数を 返す 



表 2-8 CObList クラスの メンバ M 数 
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それでは CObList クラスを 使って、 人ノ J した 丨*ズ丨 形 データを すべて 保存で きる ように 変! li 
しましょう 。この 変史は CDrawDoc クラスと CDrawView クラスの 丨 山 j 力に 影 博を 及ぼし ま 
す。 まず M 形 データを 保む: する ため、 CI)rawI)oc クラスに 1 つの メンバ 変数と 2 つの メン 
バ閲 数を 沿 加し ます。 ここで も、 プロジェクト ワーク スペースで [CDrawDoc: を“ クリック 
し、 [メンバ 変数の； II 加] および [メンバ 閲 数の 追加] を 選択して メンバ 変数と メンバ 閲敉を 沿 
加す る ことが 丨丨 J ■能です （図 2-14), CDrawDoc::AddData 問 数と CDrawDoc::GetDataList 
丨对 数の 实 装は リス 卜 2-11 に 示します。 




7 ク 

r P 〇 blc(E) ^ r Priv^e<p 




卜 0 

撕 の 直 t 必 



AddDdt^O 

rwwm 

^ Publ<(E) r Pr 〇 f«ted<B) r fVivateQ) 

「 SWc<S> 厂 VrtuoK^) 



OK 
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rwm 

C Po6lic<E) r Protect«d(B> 广 Prrv 攸 <p 
厂 Sutc <&) 厂 VrtudK^ 



OK 

4^ 



図 2-14 メンバの 追加 



リス 卜 2- 1 1 CDrawDoc:: AddData 関数の 実装 （ DrawDoc.cpp) 



void CDrawDoc: : AddDataO 

{ 

CShape* pShape = new CShape; //CShape 才 ブジェク 卜の 新規 作成 

pShape->SetStyle(GetStyle()) ; "pShape に 現在の 0 形 テ - タ m-Shape をコビ — 
pShape->SetPenWidth(GetPenWidth() ) ; 
pShape->SetPenColor (GetPenColor ( ) ) ; 
pShape->SetBrushColor (GetBrushColor ( ) ) ; 
pShape->SetPointl(GetPointl〇) ; 
pShape->SetPoint2(GetPoint2〇) ; 

m^alldata. AddTail((CObject*) pShape) ; //pShape を rr^alldata に 追加 
SetModif iedFlagO ; // モディファイ フラグの セット 



CObList* CDrawDoc: :GetDataList() 

{ 

return &m_alldata; 
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岗形 データを 保存す るた めに、 CObList クラスの オブジェクトの m_alldata という メン 
バ 変数を) U 盘 します 〇 ところで、 CObList クラスが 竹理 する リストの 各 要 索の 彻は CObject 
クラスで すが、 ここで 扱いたい のは CShape クラスの オブジェクトです。 そこで、 リスト 
に 新しく 要素を 追加したり、 リストの 要ぶ を 参照したり するとき には、 CObject クラスと 
CShape クラスの 問で キャス 卜しながら 利 川す る ことにします。 今まで 使って いた メンバ 
変数、 m_shape は マウスの ス: ボタンが 離されて 2 ム を 決定す るまでの •時 的な 作:! 6 川才ブ 
ジ ェクト として 利) |j します。 

CDrawI)oc::AddData 間数は WM_LBL：TTONL；P メッセージの メッセージ ハンドラ、 
CDrawView コ OnLButtonUpIJSJ 数から 呼び 川 され、 M 形 データの リストの 末 祕に今 描 I 叫 
した M 形 デ 一夕を 追加す る ものです 。この 中で、/ ri 後に SetModifiedFlag 関数を 呼び出し 
ています が、 この 問 数を 與行 すると ドキュメントの 内界が 変 史 された ことが フレーム ワー 
クに fz •えられます 。すると、 この ドキュメントを 保存せ ずに m じようと すると、 フレーム 
ワークが メッセージ ボックスを 衣, して、 ドキュメントを 保存す るか どうか たずねて くる 
ようになります。 

次に CDrawDoc クラスの デス 卜 ラ クタで、 オブジェクトが 削除され ると きに リストに 
追加され た 丨》丨 形 データを すべて 削除す るよう に 変 史 します （リス 卜 2-12) 



リス 卜 2-12 CDrawDoc クラスの デス トラクタの 案 装 （ DrawDoc.cpp) 

CDrawDoc : : ^CDrawDoc ( ) 

{ 

POSITION pos = m_alldata.GetHeadPosition(); // リストの 先頭を 取得 
while (pos; { 

delete (CShape*) (m_alldata.GetNext (pos) ) ; 

// GetNext 間数の 返り 僅が 指す オブジ i クトを 削除 
//pos は 次の 要素を 指す 

> 

m_alldata.RemoveAll() ; 



デス トラクタ 中では、 CObList::GetHeadPosition 間数で 先頭の 要素の 位砰を 取得し、 while 
ループの 中で CObList::GetNext 関数を 繰り返し 呼び出して、 すべての 要素を 削除し ます。 
これと よく 似た 操作が 以前 出て きた ことを 党え ている でしょう か？ ドキュメント 才 ブジェク 
ト から ビュー オブジェクトを 取得す るた めに 利用した CDocument::GetFirstViewPosition 
間数と CI)ocument::GetNextView 閲 数が それです 。このような イく 特定 倘のデ 一夕す ベて 
に アクセス する 手法の ことを イテ レー シ ヨンと 呼びます。 



*1 デス トラクタに 処理を i:;il 还 せずに、 CDocument::DeleteContents 丨对 数を オーバーライド する こと も 
芩 えられる が、 ここでは デス トラクタに データを 削除す るた めの コードを 戈 装した。 



2.7 描いた 図形の 保存 



285 



♦ビュー クラスの 変更 

次に CDrawView クラスの 変 吏を 行います 〇 CDrawView クラスに 対する 変更 点は、 マウ 
スのん ボタンが 離されたら そのと きの 丨却 形 デ 一夕を リストに 追加す るよう に 、 OnLButtonUp 
閲数 内から CDrawDoc : AddI ) ata 閲 数を 呼び出す ようにす る ことと、 リストに 登録され て 
いるすべ ての M 形 データを 描丨由 i する ように OnDraw 閲 数を 変 史 する ことの 2 点です 。リス 
卜 2-13 は 変更を 加えた OnLButtonUp 関数です。 



リス 卜 2-13 CDrawView::OnLButtonUp 関 致への コードの 追加 （DrawView.cpp) 

void CDrawView : :OnLButtonUp(UINT nFlags, CPoint point) 

{ 

CDrawDoc* pDoc = GetDocument () ; 

CDC* pDC ; 

...中略 

case Elli: 

pDC->Ellipse(ptl .x, ptl.y, pt2.x, pt2.y); 
pDC->SelectObject(&Brush) ; 
pDC->SelectObject(&drawPen) ; 
pDC->SetR0P2(R2.C0PYPEN) ; 

pDC->Ellipse(ptl .x, ptl.y, point. x, point. y); 
break; 

> 

P Doc->AddData(); // 図形 デ一 タを リストに 追加 

pDoc->UpdateAllViews (this) ; // すべての ビュ一 を 更新 

pDC->SelectObject (pOldPen) ; 

ReleaseDC(pDC) ; 

ReleaseCaptureO ; 



OnLButtonUp IW 数 内では、 CI ) rawDoc :: AddData 閲 数を 呼び出した 直後に CDocume 
nt :: UpdateAllViews 問 数を 呼び出し ています 。これは、 1 つの ドキュメント に対して 複数 
の ビューが 用: 6： されて いる 場合 （[ウィンドウ] - [新規 ウィンドウ] などを 選択した 場合) 
に 必要な 処 PR です。 ある ビューに 対して ユーザーが 何ら かの 操作を 施す と （この場合は マ 
ウスを 使って 丨义丨 形を 描く）、 それに よって ドキュメントの 内稃 が変史 される わけです が、 そ 
のとき には ドキュメントの 内容を 他の ビューに 反映させる 必要が あるで しょう。 そこで 実 
行す るの が CDocument :: UpdateAllVie \ vs 閲 数です 。この 閲 数を 呼び出す と、 引数に 指定 
した ビュー 以外の ビューの クライアント 領域の 更新が 行われます （図 2 - 15) 0 この場合は、 
OnLButtonUp 1对 数 内です でに クライアント 領域に 丨 •ズ丨 形を 描丨由 i して ある ビューに 間して は 
史新 する 必要がない ので、 リ丨 数に this を指逛 している のです。 リ丨 数に NULL を 指定した 場 
合には すべての ビューに ついて クライアント 領域の 更新が 行われます 0 
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図 2-15 画面 更新の メカニズム 



CI)rawView::OnDra\v •閲 数では、 CDrawDoc クラスの デス トラクタと 丨 "j じように、 イ 
テ レー シ ヨンを 利 川して、 リストの すべての •&: ぶを 収得して M 形を 描 丨叫 します 。そのほか 
の 部分に ついては OnLButtonUp 閲 数と 丨"1 様な 処 邢 をして います 〇 OnDraw 問 数の コード 
を リスト 2-14 にボ します。 

リス 卜 2-14 変更した CDrawView::OnDraw 問 数 （DrawView.cpp) 

void CDrawView: :OnDraw(CDC* pDC) 

{ 

CDrawDoc* pDoc = GetDocument () ; 

CObList* pDataList = pDoc->GetDataList () ; // 0 形 テ— タの リス 卜を 取得 

POSITION pos = pDataList->GetHeadPosition(); // リス 卜の 先頭を 取得 
CShape* pShape ; 

CPen Pen; 

CPen* pOldPen; 

CBrush Brush; 

CBrush* pOldBrush; 

CPoint ptl, pt2; 

while (pos) { // 図形 データが ある 限りは 以下の 作業を 行う 

pShape = (CShape*) (pDataList->GetNext (pos) );// テ- タの 取得 
ptl = pShape->GetPointl() ; 
pt2 = pShape->GetPoint2() ; 

Pen . CreatePen (PS. INSIDEFRAME , pShape->GetPenWidth ( ) , pShape->GetPenColor ( ) ) ; 
pOldPen = pDC->SelectObject (&Pen) ; 

Brush . CreateSolidBrush (pShape->GetBrushColor ( ) ) ; 
pOldBrush = pDC->SelectObject (&Brush) ; 

switch (pShape->GetStyle()) {// 図形の 描画 
case Line: 

pDC->MoveTo(ptl) ; 
pDC->LineTo(pt2) ; 
break; 
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case Rect: 

pDC->Rectangle(ptl.x, ptl.y, pt2.x, pt2.y); 
break; 
case Elli: 

pDC->Ellipse(ptl .x, ptl.y, pt2.x, pt2.y); 
break; 

} 

pDC->Select0bject(p01dBrush) ; 

Brush. DeleteObjectO ; 
pDC->SelectObject (pOldPen) ; 

Pen. DeleteObjectO ; 



以丨 ••で、 人力した すべての M 形 データを 保む: できる ようになった ので、 もう ウィンドウを 
内 描丨 叫しても、 今までに 描いた M 形が 消えて しまう こ ともなくな りました。 次は CDrawDoc 
クラスに シリアライズを 欠 装して、 M 形 データを ファイルとの 丨⑴ で や丨） 取りで きる ように 
します „ ここからは ドキュメント クラスの 屮 だけの •丨 1*； •になって くるので、 CDrawView ク 
ラスに 対する 変！ li はこれ で 終わりです 。残りは すべて CDrawDoc クラスと CShape クラ 
ス に対する 変* ii だけになります。 

參 CDrawDoc クラスの Serialize 関数 

それでは 、前 G で 扱った テキスト エディタと 丨 "1 じように、 シリアライズを 灾 装し ましょ 
う。 前 ヴ で、 MFC を 使った ブロ グラムでは 、ファイルの 入出力は すべて ドキュメント クラ 
スの Serialize 閲数 でむう ことを 解説し ました 〇 そこで、 CI)rawI)oc クラスに も Serialize 
間数を 火 装す る ことにします。 

AppWizard が 少 成した ドキュメント クラスには Serialize 閲 数が あらかじめ 丨 1丨总 されて 
いました が、 CI)rawI)oc クラスの ように ClassWizard を 使って 作った クラスに も Serialize 
問 数が 川 尨され ています 。そして、 その 本体には やはり 次の ような CArchive::IsStoring_ 
数を 使った スケルトンが 神人され ています。 プログラマは スケルトン として 用总 されて い 
る if 文の 中に W き 出し 州の 処理と 説み 込み 用の 処理を 追加す る だけで よいのは 前章で 説明 
したと おりです。 

void CDrawDoc::Seria 丄 ize(CArchive& ar ノ 

{ 

if 、 ar • isStoring() ) 

{ 

// 害き 出し 用の 処理を 行う 
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else 

{ 

// 技み 込み 用の 処理を 行う 



コードを 記述す る 前に、 まず データファイルの フ才ー マットを 決めて しまい ましよう。 保 
作す る必贤 が ある データは、 CDrawDoc クラスの メンバ 変数、 m_alldata が 竹 那 している 
CShape オブジェクトの リスト だけです から、 この リストの 内界を 光 頭 から 順に 丨 丨! : き 川し 
たり、 説み 込んだり すれば よい ことは 明らかです。 外 き 出しは 確かに それだけで 済みます 
が、 説み 込む ときには 、データファイルに いくつの CShape 才 ブジェク 卜が 保 17: されて い 
るの かわからない と If 丨丨 例です 。そこで データファイルの 先颁 には、 データファイルに A ま 
れる CShape オブジェクトの 数を 保 介す る ことにし ましよう。 



データファイル 




図 2 - 16 データファイルの フォー マツ 卜 



データの 書き出し 

データ フォーマットが 決まった ので、 まず |1!: き 出し 丨丨丨 の処邱 から 記述し ます 。 リストの 要ぶ 
数は CObLis じ GetCount 関数で 調べる ことができ ますから、 この 侦を ar オブジェクトに 
き 出します 〇 次に リストの 各 要素を 擀き 出す わけです が、 ここで も CDrawView :: OnDraw 
関数で 行った ように、 CObList::GetHeadPosition 関数と CObList::GetNext 閲 数を 使って 
イテ レー シ ヨンを 行います 3 そして、 T パ こ 人れ た CShape オブジェクトへの ポインタを 使っ 
て、 CShape オブジェクトの メンバ 変数を すべて# き 出します。 
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CDrawDoc クラスで 追加した 4 つの メンノ く変玫 （ m_style、 m_penwidth、 m_pencolor、 
m_brushcolor) はすべ て 本 f {的には DWORD 喂 （32 ビットの 符号な し幣 数） と 同等です か 
ら、 DWORD 咽に キャスト すれば、 CArchive クラスの メンバ 閲数 として 定義され ている 
<< 演 ね: 子 （リ丨 数の沏 が DWORD の もの） を 使って ファイルに 書き出す ことができます。 
しかし、 m』ointl メンバ 変数と m_point2 メンバ 変数の 2 つは CPointM の オブジェクト 
です。 CPoint 喂の オブジェクトの ための << 演 灯 f •は CArcliive クラスには) |j£: されて 
いません 。にもかかわらず CDrawDoc::Serialize 間数では、、 ド z メ C な 頷を してく く演 灯， •を 
使って います。 これは 別に C+ + •丨 V;/ 丨の 未知の 機能を 使って いる わけでは なく、 中に 別の 
場所 （Microsoft Visual Studio¥VC98¥Mfc¥include¥Afxwinl.inl) で定 在され ている だ 
けです。 また、 CArchive クラスの メンバ 閲数 としてで はなく、 グローバル 丨划 数と して) ii 
義 されて いるた め、 マニュアルを リ丨 いても 川 てこない のです。 

MFC の ソースコードを 説む ときに どうしても W •つからない 丨对 数が あったら、 「Microsoft 
Visual Studio¥VC98¥Mfc¥srcJ フォルダ にある .cpp ファイル だけでは なく、 「Microsoft 
VisualStudio¥VC98¥Mfc¥includeJ 内の .ini ファイル （インライン 問 数が 走 義 されて いる) 
を 疑って みると よいで しょう。 

データの 読み込み 

さて、 次に 説み 込み 川の 処 州! を, kl 述 します 。こちらは、 

1 • CShape オブジェクトを new 丨班兑 子を 使って〗 U 盘 する 

2. ar オブジェクトを 使って、 各 メンバ 変数の 侦を说 み 込む 

3. CObList::AddTai 丨閲 数を 呼び 川 して、 ドキュメントが 符理 する リストに CShape 才 
ブジェク トを ill 加す る 

という 処邵を ファイルに 保 介され ている CShapt 、オブジェクトの 数 だけ 繰り返します。 以 
丨 •.の 処 J*l! を まとめた ものが リス 卜 2-15 にポす コードです。 

リス 卜 2-15 CDrawDoc::Serialize M 数の 実装 （ DrawDoc.cpp) 
void CDrawDoc : : Serialize (CArchive& ar; 

CObList* pDataList = GetDataListO; //0 形 テ— タの リス 卜を 取得 
CShape* pShape ; 



if (ar . IsStoringu) 

{ 

ar << (DWORD) pDataList->GetCount () ; // 要 索 SS を 出力 

POSITION pos = pDataList->GetHeadPosition() ; 
while (pos) { 

pShape = (CShape*) pDataList->GetNext (pos) ; 
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ar << (DWORD) pShape->m.style ; 
ar << (DWORD) pShape->m.penwidth ; 
ar << (DWORD) pShape->m-pencolor ; 
ar « (DWORD) pShape->m.brushcolor; 
ar « pShape->m^pointl; 
ar « pShape->m.point2; 

> 

} 

else 

{ 

int count; 

ar » (DW0RD&) count; 

while ( ■_ count >= 0) { 
pShape = new CShape; 
ar >> (DW0RD&) pShape->m_style ; 
ar » (DWORD&)pShape->m.penwidth; 
ar >> (DW0RD&) pShape->m_pencolor ; 
ar » (DWORD&)pShape->m.brushcolor ; 
ar » pShape->m.pointl ; 
ar » pShape->m.point2; 
pDataList->AddTail((CObject*) pShape) ; 




このと き、 注 总 して 欲しい のは CShape クラスの 6 つの メンバ 変数は すべて ブライべ 一 
ト メンバだった という ことです 〇 通 常なら、 CDrawDoc クラスの メンバ 問 数からは Set 〜 
間数 か Get 〜閲 数を 介してし か、 これらの メンバには アクセスで きないは ずな のに ここでは 
何の 問題 もな く アクセスで きています 。これが friend キーワードの 幼采 です。 CI)rawI)oc 
クラスが CShape クラスの フレンド クラスで ない ときには、 シリアライズ 処押は もっと 血 
倒な ものに なって いるは ずです。 

もっとも、 これは クラスの 設計 に ミスが あった というべき かもしれ ません。 CShape ク 
ラスの ような クラスは むしろ 丨 jl なる 構造 休 か、 もしくは すべてが パブリック メンバから 構 
成される クラスで 符理 をす るべき でしよう 。シリアライズの 灾 装が 終了した、 ここまでの 
ブロ グラムは 「 MMView¥Step2 」 フォルダに 収めて あります。 



♦ CShape クラスに Serialize 関数を 実装す る 

さて、 M 形の 外 描 丨由丨 •や ファイルとの 人出 乃 もで きる ようになって、 これで ドロー ツール 
の 完成！ といいたい ところで すが、 あと 1 つ 解説したい ことがあ るので、 もう 少し おつき 
あいく ださい。 それは、 rCShape クラスに Serialize 間数を 実装す る 方法」 について です。 
「えつ？ Serialize 間数って CDocument クラスの メンバ 閲 数なん じ ゃない の？」 と思っ 
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た" は 勘递 いを しています 3 Serialize 丨幻 数は CDocument クラスの メンバ 閲 数では なく、 
CObject クラスの メンバ 関数です コ CObjcct クラスとは、 MFC が 提供す る ほとんど すべて 
の クラスの 店 政 クラスと なって いる、 ルート クラスと も哼 ベる クラスです。 つまり、 MFC 
が 提供す る ほとんどの クラスには Serialize 関数が 潜在的に 存在して いるので す 。ただ、 必 
要の ない クラスには 灾 装され ていない ために、 衣丨 〖丨丨 丨 ••には 現れない だけな のです 0 

シリアライズ 可能 クラスの メリ ッ卜 

CShape クラスに SerializHiy 数を 火 焚す ると、 どういった メリットが あるので しよう？ く 
どく ど 説明す るよりも、 CShape クラスに Serialize 閲 数を 火 装した 場 介に、 CDrawI)oc::Se 
rialize 問 数が どのように 変わる か、 W/C いただき ましよう （リスト 2 - 16 >〇 

リス 卜 2-16 変更した CDrawDoc::Serialize 関数 （ DrawDoc . cpp ) 

void CDrawDoc : : Serialize ( CArchive & ar ) 

{ 

CObList * pDataList = GetDataList () ; 

CShape * pShape ; 

if ( ar . IsStoringO ) 

{ 

ar « ( DWORD ) pDataList -> GetCount () ; 

POSITION pos = pDataList -> GetHeadPosition () ; 
while ( pos ) { 

pShape = ( CShape *) pDataList -> GetNext ( pos ) ; 

ar « pShape ; // ドキュメント クラスでの シリアライズ はこれ だけ 

} 

> 

else 

{ 

int count ; 

ar » ( DW 0 RD &) count ; 
while ( count >= 0) { 

ar » pShape ; // ドキュメント クラスでの シリアライズ はこれ だけ 
pDataList -> AddTail (( CObject *) pShape ) ; 

} 

> 



今までは CShape クラスの メンバ 変数を 1 つ 1 つ ar オブジェクトを 使って 説み i 1 !: きし 
ていたの が、 CShape オブジェクトが まさに 1 つの オブジェクト として ar 才 ブジェク トを 
使って, 泣み I 1 !: きで きる ようになって いるの がわ かります 。 これ だけで も、 CShape 才 ブジェ 
クトを 説み, 丨! : きして いる ことが はっきりして、 非常に プログラムが わかりやすくな ってい 
ます。 本 プログラム のように 比較的 中. 純な データ 構造を 竹理 する ドキュメント クラスで さ 
え、 これ だけの 効 米が あるので すから、 より 複雑な データ 偁 造を 扱う ドキュメント クラス 
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ならば、 見通しの よさが 格段に 違って きます。 

また、 ドキュメント クラス 以外の クラスに Serialize 問 数を 実装した 場合には、 その クラ 
スの才 ブジェク トを 畓 き 出す ときには、 フレームワーク によって データの 前に クラスの 識 
別 子が 出力され ます。 この 識別子は 読み込み 時に 参照され、 フレームワーク により 沏チ ェッ 
クが 行われます。 このように、 安 企に ファイルの 人出 力を 行うた めの サービス も 受ける こ 
とが できるようになる のです。 

Serialize 関数が 呼び出される とき 

ここまでの 説明を 読んで、 「なぜ CArchive クラスの 才ブジ ヱ クトを 使って 説み 丨丨! •きす 
ると、 Serialize 関数が 呼び出される のだろう？」 と 疑問に 思って いた 方 も 多い かと 思い ま 
す 。ここでは、 Serialize 間数が 呼び出され るまでの フレームワーク 内の 動作に ついて、 ド 
キ ュメン トクラス とそれ 以外の クラスに 分けて 説明し ます 。ドキュメント クラスと それ 以 
外の クラスでは、 Serialize 問 数の 呼び出され 力が 迩 うこと に 注 总 してく ださい 0 

まず ドキュメント クラスの 場合を 説明し ましょう 。ドキュメント クラスの Serialize 叫 数 
は、 フレームワークが )| 丨盘 した ファイル オープン ダイアログ ボックス などを 使って フ ァイ 
ルを オーブンした ときに 呼び出される ことは すでに お， ifi ししました 0 
たとえば、 メニューから [ファイル]- [丨》1く] を 選択した 垛 介を 冬え てみ ましょう 〇 Ap 
pWizard が 生 成した コードでは、 この メニュー 頊 II を 選択す ると、 フレームワークに よっ 
て CWinApp^OnFileOpen 問 数が 呼び出され 、ファイル オーブン ダイアログ ボックスが 衣 
ポ されます 。次に、 OnFileOpenlW 数から、 ダイアログ ボックスで ユーザーが 指定した ファ 
イル 名を 引数と して CDocument::OnOpenDocument 閲 数が 呼び出されます 。ここでは、 
CArchive オブジェクトの 作成、 ファイルの オーブン、 Serialized 数の 呼び出し、 ファ イ 
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図 2-17 ダイアログ ボックスを 通して 呼び出される 壩合 
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ルの クローズが 順に 行われます （図 2-17> 0 つまり、 ドキュメント クラスの Serialize 関数 
は C Archive クラスの << 演筇子 や >〉 演鈦 子を 使わずに、 フレームワークから 邀接 関数 
名を 指定して 呼び出される のです。 

以上は 読み込みの 場 介でした が、 [ファイル]- [保存] を 選択した とき も、 フレーム ワー 
ク によって 丹き 出し 用に、 ほぼ 同様の 処理が 行われます。 

次に ドキュメント クラス 以外の クラスの 場合に ついて です 〇 これらの クラスの Serialize 
IW 数は、 CArchive オブジェクトを 通して、 <<演灯 了 •や >>演 灯 了 •などを 使って 読み 齊 
きをす ると 呼び出されます。 

例と して、 CShape クラスに Serialize 間数を 実装した ものと して 説明し ましょう 。シリ 
アラ イズ が灾 装され た オブジェクトの 入出力には、 CArchive オブジェクトを 使える こと 
はすで に 説明し ました 。その 具体的な 使い方は リス 卜 2-16 でも 紹介して いますが、 次の 
ようにして 使います。 

CArchive ar; 

CShape* pShape; 

ar << pShape; // CShape オブジェクトの 害き 出し 

ar >> pShape; //CShape オブジェクトの 找み 込み 

さて、 ここから どのよう にして CShape :: Serialize 関数が 呼び出される のか、 読み込みの 
場 介を 例に して 追ってい くこと にします 〇 「 ar 〉> pShape :」 のように >>演灯 子の 左项に 
CArchive オブジェクト、 右 瑣に CShape オブジェクトへの ボ イン 夕を 妃时 すると、〉〉 
演 t ): 了 •によって 奕 際に 実行され るのは 



CArchiveft operator»(CArchive& ar, CShape* pShape) ; 



です。 しかし、 このような 問 数が フレームワークに 用竞 されて いるは ずがありません 。な 
にしろ CShape クラスは 私述が 作った クラスな のです から 。といっても このような 間数を 
ブロ グラマが 逛義 する 必要はありません 。灾 は、 フレーム ワークに 用： e されて いる マクロ 
( I ) ECLARE _ SERIAL と IMPLEV 1 ENT _ SERIAL ) を 使えば、 IKJ 数の ブロ 卜 タイプ 宣言 か 
ら閲数 本体の 走 在まで やってくれ るので す。 マクロに よって 定義され た 数の 本体では、 
CArchive ン ReadObject 間数を 呼び出し ています 。そして、 CArchive :: ReadObject 閲 数の 
中から、 CShape :: Serialize 関数が 呼び出される のです 0 
以上が > >演 灯， •での 読み込み によって Serialize 問 数が 呼び出され るまでの 経路です。 
次に 書き出しの 場合に ついて 見て みましょう 。今度は 読み込みの 場合とは 違って、 ブ ログ 
ラマが （マクロを 使って） << 演笕 子を 用意す る 必要はありません 0 実際には、 フレーム 
ワークから 次の 閲 数か飞 f び 出されます。 



CArchive& operator«(CArchive& ar, const CObject* pOb) 
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そして、 笫 2 リ I 数、 CObject クラスの 才 ブジェク 卜への ポインタが 指す オブジェクトの 
Serialize 間数が 呼び出されます 。よって、 Serialize 関数を 实装 する クラスは、 CObject ク 
ラスの 派 十. クラスで なければ なりません 3 とはいっても、 Serialize 閲 数は そもそも CObject 
クラスの メンバ 閲 数です から、、 |'丨 然と いえば、 レ 丨然 です。 このように、 説み 込み ，丨!: き 出し 
で递 いが あるのは 、「派 中 •クラスの ポインタは 故 政 クラスの ポインタ （こ 代人で きる が、 邛 
成 クラスの ポインタは 派 4: クラスの ポインタに 代人で きない」 という C ++“ 訊の 化 様が あ 
るた めです 。ここでは •市し く •说 明し ません ので、 よく 冬え てみ てくだ さい。 

•Ud の 間数の 本体では、 CArchive::WriteObject 間数を 呼び 川 しています。 そして、 
CArchive::WriteObject 閲 数の 屮 から、 CShape::Serializc 数が 丨丨 f び 川され ます。 以上が 
ドキュメント クラス 以外の クラスに 火 焚した Serialize 間数が 呼び出され るまでの 流れで 
した。 

ところで 、ドキュメント クラスの Serialize 閱 数は フレームワークから 呼び 川され ます 
が、 ドキュメント クラス 以外の クラスの Serialize 閲 数が 时 •び 出 される きっかけ となる、 
<<浈灯 广と >>演 灯 f •はいつ 使われる のでしょう？ それは、 ほとんどの 坳介 ドキ ュメン 
卜 クラスの Serialize 閲 数の 屮 となる はずです 3 フレームワークから ドキュメント クラスの 
Serialize 閲 数が 呼び 川 される と、 そこで ブロ グラマが 記 述 した コードが 火 行され る ことに 
なります。 ブロ グラマは、 おそらく ドキュメント クラスの メンバ 変玫を ファイルに 保“ し 
ようとして、 <<演灯， •と >>演 灯/ •を 使う でしょう。 ブロ グラマが その メンバ 変数の ク 
ラス （この 例では CShape クラス） について きちんと シリアライズを 火 焚して いれば、 ここ 
で その クラスの Serialize 閲 数が 丨丨 f •び丨 li される わけです* 2 。 

CShape クラスを シリアライズ 可能 クラスに 書き換える 

ある クラスに Serialize 閲 数を 灾装 する ために 必要な 条件を 拙 m すると 以ド のように なり 
ます。 

•その クラスは CObject クラスの 派卞 クラスで ある （ if (接で ある 必災 はない） 

• DECLARE-SERIAL マクロと IMPLEMENT_SERIAL マクロを 利 川して いる 

これらの 条件を 満たす ように、 DrawDoc.h で逛 族され ている CShape クラスを リスト 
2-17 のように 変! おしましょう。 



*2 もしくは ドキュメント クラスの Serialize 閲 致の 中で ar を 引数に シリアライズを 行う オブジェクトの 
Serialize 閲 数を そのまま 呼び出す こと も "f 能 
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リス 卜 2-17 変更した CShape クラスの 定義 （DrawDoc.h) 



class CShape : public CObject //CShape クラスを CObject クラスの 派生 クラスと した 

{ 

friend class CDrawDoc; 

DECLARELSERI AL (CShape ) // シリアライズ 可能 クラスで ある ことを 篁 首す る 




STYLE m.style; 
int m.penwidth; 
COLORREF m.pencolor ; 
COLORREF m.brushcolor ; 



CPoint m-pointl; 
CPoint m_point2 ; 



// 図形の 種類 
// ペンの 太 さ 
"ペンの 色 
/ ✓ブラシの 色 
// 第 1 の 点の 座摞 
// 第 2 の 点の 座摞 



public: 






void 


SetStyle (STYLE s) 


{ m.style = s; > 


void 


SetPenWidthCint w) 


{ m.penwidth = w; } 


void 


SetPenColor (COLORREF c) 


{ m.pencolor = c; } 


void 


SetBrushColor (COLORREF c) 


{ m.brushcolor = c; 


void 


SetPointl (CPoint pt) 


{ m.pointl = pt; } 


void 


SetPoint2 (CPoint pt) 


{ m.point2 = pt; } 



STYLE 




COLORREF 

COLORREF 



GetStyleO 

GetPenWidthO 

GetPenColorO 

GetBrushColorO 



{ return m.style; > 

{ return m.penwidth; > 

{ return m.pencolor; } 

{ return m.brushcolor ; > 



CPoint GetPointlO { return m.pointl; } 

CPoint GetPoint2() { return m.point2; > 



void Serialize (CArchiveft ar) ; //Serialize 闋 数を 竇 首す る 

>； 



ポイントは、 



♦ CShape クラスを CObject クラスの 派生 クラスに 変更 
• 「 DECLARE - SERIAL ( CShape )」 という 1 行を 追加 

♦ Serialize 関数を 追加 



の 3 戌です 〇 DECLARE - SERIAL マクロの 敁 後には セミコロン （ ； ） は 必要ない ことに 注 
意して ください 。あとは DrawDoc . cpp に CShape :: Serialize 関数を 実装し、 マクロを 1 つ 
追加す る だけです。 この場合の Serialize 関数 も 今までと 同じような、 標準 的な 構造を して 
います （リス 卜 2-18)。 



295 



296 



2 ド □一 ツールを 作って みよう 



リスト 2-18 CShape::Serialize 関数の 実装 （ DrawDoc.cpp) 



111111111111111111111111111111111111111 

// CShape シリアライズ 

IMPLEMENT_SERIAL(CShape, CObject, 0) 

void CShape : : Serialize (CArchive& ar) 

{ 

if (ar . IsStoringO ) 

{ 

ar << (DWORD) m.style; 
ar << (DWORD) m_penwidth; 
ar << (DWORD) m.pencolor; 
ar « (DWORD) m.brushcolor ; 

ar << m.pointl; 

ar << m_point2; 

> 

else 

{ 

ar » (DW0RD&) m.style; 
ar >> (DW0RD&) ra.penwidth; 
ar >> (DW0RD&) m.pencolor; 
ar >> (DW0RD&) m.brushcolor ; 
ar >> m.pointl; 

ar » m_point2; 



CShape::Seria 丨 izelKJ 数の 丨人 は、 以前の CDrawDoc::Serialize メンバ 関数で 行って いた 
処刊! •を そのまま 持って きた だけで ある ことが わかる と 思 います。 以丨 •.で、 CShape クラス 
への シリアライズの 火災は 終わりです 。ここまでの ブロ グラムは 「 MMView¥Step3」 ディ 
レクト リに 収めて あります 



第 4 部 

Windows らしい 

アプリケーションを 作って みよう 



第 3 部に 引き続き、 第 4 部で もちょつ とした アブ 
リ ケー シ ヨンを 1 つ 作成し ます。 第 3 部で 作成した 
MMView の キーワードは 「ドキ ュメ ン卜ー ビュー •アー 
キテ クチャ」 でした が、 今回の キーワードは 「コン 卜 
□一 ル J です。 コン 卜 □一 ルと いえば、 Windows アプ 
リ ケー シ ヨンの ユー サ 一 インターフェイスを 担う、 し、 わ 
ば、 アプリケーションの 顔です 。 Windows 95 以降、 
少しずつ Windows アプリケーションの デザインが 変 
わって きている ように 感じられ るのは、 ち ゃくち ゃく 
と 追加され る 新規 コン 卜 □一 ルに よると ころが 大きい 
よ ラです。 

コント □一 ルの 使い方 （ DDX / DDV ) について はす 
でに 第 2 部で 解説を 終えて いますが、 第 4 部では よ 
り 突っ込んだ コン 卜 □一 ルの 使い方に ついて 解説を 行 
います。 DDX / DDV は 手！? である 反面、 できる こと 
も 限られて います。 コン 卜 □一 ルを 使いこな すには、 
DDXXDDV を 使わない 方法を 学ぶ 必要が あります。 

第 4 部では、 ツリー ビュー コン 卜 □一 ルと HTML コ 
ン卜 □一 ルを 題材に、 細かな コン 卜 □一 ルの 使い方を 
解説し ます。 



URL マネージャの 概要 



Visual C ++ では DDX / DDV という 憷梆を 使う ことによって、 ダイアログ ボックス など 
での ユーザー インターフェイスを ほとんど コントロール ごとの 迩 いを 立 識 せずに 作る こと 
がで きます （これにつ いては 第 2 部で 解 •兑 したした だし、 これは 「コントロールが 持つ 侦を 
設化 、取得す る」 という ごくごく 1 i 1 •純な 作 袋 だけを する 場 介に 限られます 。エディッ トボッ 
クス や リスト ボックスの ような ダイアログ ボックスで 侦 川す る S 丨の簡 中な コントロールな 
らば、 確かに I ) I)X I ) I ) V は イ丨効 な！ 段です。 しかし、 说 / 丨 •: では コントロールの 機能は 极 
靴 化する •力 •です。 たとえば、 エクスプローラで 使われて いる ツリー ビュー コントロール 
(ディレクトリ ツリー （ノ ド: 側の ペイン〉 で 使われて いる） や リスト ビュー コントロール （ファ 
イル リスト Ui 側の ペイン〉 で 使われて いる） などの 坳介 、「コントロールが 持つ 侦を设 走、 
収 W する」 だけでは 糾 御し きれない ことは - I 丨阶然 です」 ざっと 芩 えて みても、 アイテム 
の 挿 人、 ビットマップの •没定 、ラベルの 褊叱 など、 とても DI)X I ) DV だけでは 扱い きれ 
ない 作龙 が必 •&: である ことが わかります。 

そこで、 第 4 部では I ) I)X I ) DV を 使わずに、 コントロールを 制御す る 力 •法を ツリー 
ビュー コントロールを 題材に 解説し ます。 また Visual C ++ 6.0 で 追加され た HTML コン 
トロール も简 中. に 使⑴ します 。これらの コントロールを 丨 ) I)X DDV を 使わずに 制御す る 
坳介 は、 各 コントロールに 依む ••する 作* が必毋 になる ので、 解説 も コントロール ごとに 依 
介す る ものになります。 したがって 、第 4 部で 解説で きる コントロールは ツリー ビ ューコ 
ン トロールに 吸 られ てし まいます が、 ご r 准く ださい 0 

1.1 URL マネージャの 使い方 

さて、 丨 •.述 したよう な コントロールの 使い方を 解説す るた めに 川 立した サンプル アプリ 
ケー シ ョンを 紹介し ましょう 。この アプリケーションは 「 URL マネージャ」 と 名付けられ、 
図 1-1 のよう な 外観を しています 0 



1 URL マネージャの 概要 
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図 1-1 URL マネージャ 

エクスプローラ のように メイン ウインドウは 2 つの 領域に 分けられ ていて、 ノ r : 側の 領域 
には ツリー 状に URL の リストを 衣，〗 i し、 心 側の 領域には Web ページを 衣ボ します。 この 
左側の 領域に 使われて いる コントロールが ツリー ビュー コントロールです 。また、 イ丨 •側の 
領域に 使われて いる コント ロ一ルが HTML コントロールです 。ちょうど、 エ クス プロ 一 
ラの エクスプローラ バーに 「お 铽に 人り」 を 衣, パ したと きと 丨 „j 等の 機能を 持った アブリ ケ- 
ン ヨンです。 

URL マネージャに 衣 示す る URL リス 卜は、 Internet Explorer 4.0 ( 以後 IE4.0 と 略す） 
で符理 されて いる 「お 気に 人り」 から 作成し ますが、 ブロ グラムを 电 純化す るた めに、 URL 
マネージャ 肖 身には 「お z パに 入り」 を 取彳! f する 機能を 持たせて いません。 そこで、 代わり 
に lsurl.exe という ツールを〗 11盘 しました 〇 lsur 丨ツー ルを 起動す ると、 攻^: ログオンして 
いる ユーザーの 「お铽 に 入り」 を 調べて、 赍鉍 されて いる URL と タイトル、 それに フ才ル 
ダを 抜き出して 1 つの テキストファイルを 新規 作成して 記録し ます 0 URL マネージャは、 
この lsurl ツールが 作成した テキスト ファイルを 説み 込んで、 ツリー ビューに 表示し ます。 
lsurl ツールに ついては 本み が 扱う 範 I 用を 越える 内袢 になる ので 解説は 割愛し ますが、 ソー 
スコー ドは 付 城 CD-ROM に 収録され ている ので （URLMan¥lsURL)、 興味が あれば 解析 
してみ てくだ さい。 





1.2 URL マネージャの 構造 



1.2 URL マネージャの 構造 

AppWizard を 起動して スケルトンを 作成す る 前に、 URL マネージャの 大まかな 構造を 
解説して おき ましょう。 

AcldressBook の ゥィンドウは 2 つの 領域に 分かれて いると 述べました が、 このような 1 
つの ウィンドウの 中に しきいを) II 总 して 複数の 領域に 分けて 使う テクニックを スプリット 
ゥィン ドゥと 呼びます （図 1-2) 0 スプリット ゥィンドウの それぞれの 領域の ことは ペイン 
と丨丨 f びます 。ペイン （pane) とは 窓ガラスの ことです 。ゥィンドゥの 中に ある 丨メ: 切られた 領 
域 だから ペイン （窓ガラス） という わけです。 
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ペイン 



スプリット ウインドウ 



図 1-2 スプ リツ 卜 ウィンドウ 

こうして 作られた ペインの それぞれには ビュー クラスを 割り当てて、 通常の ビュー ウィ 
ン ドウと まったく 向 じように 扱う ことができます 。つまり、 ペインを 複数 用意 すれば、 1 
つの ウィンドウ （アプリケーション） で 複数の ビュー クラスを 利用で きる のです。 第 3 部の 
MMView でも ビュー クラスを 複数 使って いました が、 このと きは ドキュメント クラス も 
複数 存在して いて、 1 つの ビュー クラスに 1 つの ドキュメント クラスが 対応して いました 0 
しかし スプリット ウィンドウを 使う ときには、 1 つの ドキュメント クラスに 複数の ビュー 
クラスが 対応す る ことになります （図 1-3) 0 

URL マネージャでは CURI/TreeView クラスと CBrowserView クラスと いう 2 つの ビ 
ュー クラスを 作成し ます 〇 CURLTree View クラスは CTree View クラスの 派生 クラスと 



301 



URL マネー 



MMView の 場合 

ドキュメント クラスと ビュー クラスが 1 対 1 に 対応 



CTextEditDoc 



CTextEditView 



CDrawDoc 



CDrawView 



UR じ? ネー ジヤの 場合 

1 つの ドキュメント クラスに 2 つの ビュー クラスが 一関 係して いる 



CURLManDoc 



CURLTreeView 



CBrowserView 



図 1-3 MMView と URL マネージャ 

Oil ぶします。 CTreeView クラスは、 ツリー ビュー コント 口一ルを ビュー 
侦 うため の クラスです， また CBrowserView クラスは CI 丨 tmlView クラスの 讲 
して 定義し ます， CHunlView •クラス も CTreeView クラスと M じように、 in 
ロールを ビュー クラスと して 使うた めの クラスです。 

HTML コン 卜 ロールの 機能は、 出 4.0 とまった く丨 "J じです。 HTML の サボ 
Vd 令に •致します し、 ActiveX コン 卜 ロ一ル や Java も サポートされ ています 
ロキ シーサー バーの 役记 は IE 4.0 の ものを | 丨 :: 借し ます。 IE 4.0 も HTML コン 
使 川して 作られて いるので、 これらは 兴然 のこと です。 

これら 2 つの クラスは、 第 3 部で 使; 丨 1 した CEdit View クラスと M じように、 
トロ一ルを まるまる ビュー クラスと して 桃うた めじ 丨丨丨 ••气 わ ハク 弓 フ で 十 ゲ , 




URL の 内容を 表示す 



CMainFrame 

CAboutDIg 

CURLEntry 



フレーム ウインドウ クラス 
アバウト ダイアログ ボックス 
URL を 記憶す るた めに 使用す る 



URL マネージャで 使用す る クラス 一 覧 





スケル 卜ンを 作る 




クトが 作成され ると M 時に コントロール も 作成され、 ビュー ウインドウ 全体を 丨 1 丨 •める よう 
に コントロールが 配 骹 されます 0 

以丨 ..2 つの クラスの ほかに も、 通常の SDI アプリケーションで 使用され る 表 1-1 に 示す 
ような クラス、 および ドキュメント 丨丨 I 補助 クラスが 1 つ 存在し ます。 これらの クラスに つ 
いては 2 负 以降で 解説して いきます。 



1.3 スケルトンを 作る 



それでは いつもの ように AppWizard を 使って スケルトンを 作成す る ことにし ましよう 0 
[プロジェクト 名] は [ URLMan ] とします 〇 ほとんどの 設定 项丨1 は デフ ォルトの ままです 
が、 ステップ 1 の [作成す る アブリ ケー シ ヨンの 夕 イプ] を SDI に、 ステ ッブ 6 の ビュー 
クラスの 名丨 ’丨! 丨と从 底 クラスを それぞれ、 CUKLTreeView クラスと CTree View クラスに 
変 1 Ji します （図 1-4>。 




ビュー クラスの 名前を • 

[ CURLTreeViewl に 

基底 クラスと しては • 

[ CTree View 】 を 択 
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ヘッダ— ファイル 名を 
[URLTreeView h ] に 

インプリメント ファイル 名を 
[ URUreeViewcpp 】 に 



図 1 -4 AppWizard での 変更® 所 

以上の 設定を 行ったら スケルトンの 完成です が、 今 M は 2 つの ビュー クラスを 使用し ま 
すから、 絞け て ClassWizard を 使って CBrowserView クラスを 作成す る ことにし ましょ 
う 〇 ClassWizard を 起動して 、く クラスの 追加 > ボタンを クリックして [新規] を 選択す る 
と [新規 クラスの 作成] ダイアログ ボックスが 開く ので、 [クラス 名] に [ CBrowserView ] 
を、 [接 本 クラス] に [ CHtmlView ] を それぞれ 指定して ください 〇 Ai •後に <〇 K > ボタン 
を クリックしたら CBrowserView クラスの 完成です。 

AppWizard が 手助けして くれる のは ここまで です。 これから 先は ブロ グラマが 1 つ 1 つ 
コードを 作って いく 播: です。 次に、 第 4 部での プログラマ 側の 初代が として、 URL マネー 
ジャで スプリット ウインドウを 使⑴ できる ように 加工を して おく ことにし ましょう。 
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図 1-5 ClassWizard で CBrowserView クラスを 作る 

1.4 スプリット ウインドウを 作成す る 

スブ リッ 卜 ウインドウ はとても 簡丨 ji •に 作る ことができます 。あらかじめ 作って おく 必 •炎 

の ある クラスは、 通常 AppWizard が 作って くれる CMainFrame クラス、 そして 2 個以 

丨 •.の ビ ユー クラスです 0 これらは ここまでの 作 袋です でに 川总 されて います、 あとは ごく 
わずかな コードを CMainFranie クラスに 追む 丨丨 する だけで、 ス ブリット ウィンドウが 利 川 
できる ようになります。 これらの コードは アプリケーションに よらず、 スプリット ウィン 

ドウを 使う 坳介 には 決まりきった コードと して 利⑴ できる ので、 UKL マネージャ 以外の プ 
ロ ジヱク 卜に も 使い I " 丨 しが " J * 能です。 



_ メンバ 変数の 追加 

まずは、 スブ リツ 卜 ウインドウを 利 川す るた めに 必 •及: な メンバ 変数を 汜加 します まず 
ワーク スペース ウインドウの ： G ass \ j ew こ ページで [ CMainFrame クラス] を ダブル クリッ 
ク するな どして、 MainFrm.h を 問いて ください 。すると そこには CMainFrame クラスの 
在が 述 されて いるので、 そこに 次の 1 行を 沿 加して メンバ 変数を 追加して くださ ぃ （リ 

スト 1-1) 0 



リス 卜 1-1 メン八 里数の 追加 （ MainFrm . h ) 

class CMainFrame : public CFrameWnd 
{ 

• • • 

public: 

CSplitterWnd m.wndSplitter; 

} 



1.4 スプリット ウィンドウを 作成す る 



m_wndSplitter メンバ 変数は CSplitterWnd クラスの オブジェクトで、 フレーム ウイン 
ドウの クライアント 領域を 乘っ 取る II 的で 使われます。 通常 フレーム ウインドウの クライ 
アン ト 領域は ビュー ウインドウが ff 坪して います。 これは CMainFrame クラスの 浓底 クラ 
ス である CFrameWnd クラスの OnCreateClient メンバ 間数の 中で、 フレーム ウインドウ 
の クライアント 領域に 指定され た ビュー ウィンドウを 割り当てる、 という 処理を 行って い 
るからで す 〇 CFrameWnd::()nCreateClient メンバ 間数は フレーム ウインドウの ク ライア 
ント 領域を 初期化す るた めの 問 数です から、 CMainFrame クラスで この メンバ 問 数を 才ー 
バーラ イドして、 フレーム ウインドウと ビュー ウインドウの 問に スプリット ウインドウが 
剖って 人る ように すれば、 スプリット ウインドウが フレーム ウインドウの クライアント 領 
域を 竹 那 できるようになる わけです 。これに よって、 ビュー ウインドウの 親 ウインドウは 
スプリット ウインドウ になり、 スプリット ウインドウの 親 ウインドウは フレーム ウインド 
ウ になります （図 1-6)。 

URL マネージャの ビューの 構造 




參 クライ アン 卜 領域を 乗っ取る！ 

次に CMainFrame::OnCreateClient メンバ _ 数を 追加して、 フレーム ウインドウの ク 
ライアン ト領 域を 乘っ 取る ための コードを 紀 述 する ことにします。 OnCreateClient メン 
バ関 数は CFrameWnd クラスの 仮想 メンバ 間数です から 才ー バーラ イド すれば よいで 
しょう。 才ー バーラ イドには ClassWizard か WizardBar を 使います。 表 1-2 に 示す 指定 
で CMainFrame::OnCreateClient メンバ 閲 数を 作成して ください （図 1-7)。 




BOOL CMainFrame: :OnCreateClient(LFCREATESTRUCT lpcs, CCreateContext* pContext) 



if ( !m.wndSplitter.CreateStatic(this, 1, 2) II 

!m.wndSplitter.CreateView(0, 0, RUNTIME.CLASS(CURLTreeView) , 
CSize ( 100 , 100) , pContext) I I 

!m.wndSplitter.CreateView(0, 1, RUNTIME.CLASS(CBrowserView) , 
CSize(0, 0), pContext)) { 

TRACE0( M fail to create splitter window") ; 
return FALSE; 

} 

return TRUE; 








また MainFrm . cpp の 先 如に、 リス 卜 1-3 に尔す ヘッダ ファイルの 説み 込みを 追加す る 
の も 忘れないで ください。 

リスト 1-3 ヘッダ ファイルの インク) U — ド （ MainFrm . cpp ) 

#include •'URLManDoc .h" 

#include "URLTreeView . 

#include "BrowserView . 



? スプリット ウィンドウを 使うた めの コードの) n 加は 終 r です 。ここ ま 
くイル 火む すれば、 図 1-8 に尔 すよう に 2 つの ペインが 衣氺 される プ 
〔す 。もっとも ビューには 河 も衣尔 されない のでつ まらない ものです が 




図 1-8 実行 画面 



ドに ついて 

eateCliem メンバ 間玫に ik ! 述 した コードでは、 次の 2 ステップで ス プリ 
I : 成して います。 

< インの 钕を 定義す る （ CSplitterWn と CreateStatic ) 

$ ペインに ビュー クラスを 割り、 丨’丨 てる （ CSplitterWnd::C reate View ) 



；> 2 つの メンバ 関数は 以 ドの ような ことを 行って くれる ものです。 
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BOOL CreateStatic(CWnd* pParentWnd. int nRows. int nCols. 

DWORD dwStyle = WS.CHILD I WS.VISIBLE. 

UINT nID = AFX_IDW.PANE_FIRST) 



返り 侦 BOOL 

リ丨数 CWnd* pPare/z/Wnd 
int nRows 
int nCols 
DWORD dwStyle 



成功 すれば TRUE、 失敗 すれば FALSE 
親 ウインドウ （通常は フレーム ウィンドウ） 

縦 方向に 並べる ペインの 数 （16 以下を 指定) 

横 方 叫に# •ベる ペインの 数 （16 以 ドを 指定） 
スプリット ウインドウに 指定す る ウインドウ スタイル 



UINT nID 



，•ウインドウ II) 



BOOL CreateView(int row, int col, CRuntimeClass* pViewClass. 

SIZE sizelnit, CCreateContext* pContext) 



返り 侦 BOOL 

リ I 数 int roo; 
int col 

CRuntimeClass* pViewClass 
SIZE sizelnit 

CCreateContext* pContext 



成功 すれば TRUE、 失敗 すれば FALSE 

•削り 肖て る ペインの 位 吖（ I •.端の ペインが ⑴ 

割り 逛 てる ペインの 位时 （ノ r : 端の ペインが 〇) 

作成す る ビューの クラス 

••切り 肖て る ペインの 初期 サイズ 

ビューの 作成に 必 •及: な 丨 •丨報 （迎常 は OnC rea t e 

Client メンバ 間数の 引数を そのまま 渡す） 



したがって、 OnCreateClient メンバ 関数では、 

CreateStatic(this, 1, 2) 

として、 縦に 1、 横に 2 つの ペインを 並べ、 次に 
CreateView(0, 0, RUNTIME-CLASS (CURLTreeView), …… ） 

を 奕 行して、 左側の ペインに CURLTreeView クラスを 割り当てて、 •後に 
CreateView(0, 1, RUNTIME.CLASS(CBrowserView) , ) 



として 右側の ペインに CBrowserView クラスを 割り当て ていたと いう わけです 



1.4 スプリット ウィンドウを 作成す る 



春 コンポ 一 ネン卜 ギヤ ラリ 

ところで、 本節で 述べた スプリット ウインドウは、 ほとんど： f -丨! ■(しせずに、 そのままの 方 
法で 他の アプリケーション にも 組み込む ことができます 。 こうした W 利) li4 能な モジ ユー 
ルを 保# して おいて、 次 M からはで 問 暇を かけずに 利 川したい と 思う のが 人悄 という もの 
です。 奕は Visual C+ + にはこう した モジュールを 竹 して、 プロジェクトに 簡 中に 組み 
込む 機惝 が丨 H.G: されて います。 この 憷偁 は コンポーネント ギヤ ラリと 呼ばれ、 メニュー か 
ら [プロジェクト] 一 [プロジェクトへ ill 加]- [コンポーネント および コントロール] を # 太; 
行す る ことにより 起動す る ことができます。 



ル/ w へ 嬅 入す •ネン 
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図 1-9 コンポ 一 ネン卜 ギヤ ラリ 

「あらかじめ 川总 されて いる コードを 丨丨丨 分の プロジェクトに 利 川す る」 という 点では 
AppWizard が 4: 成す る スケルトンに 通じる ものが あります が、 コンポーネント ギヤ ラリ 
は 利 州す る タイミングが AppWizard とは 興なります 〇 AppWizard は プロジェクトを ス 
タートさせる iii •初の 段附 でし か利丨 H する ことができません が、 コンポーネント ギヤ ラリは 
プロジェクトの 開発 段階の いつい かなる ときに でも 利用す る ことができます 0 

汎川 的な モジュールを ⑴盘 するならば、 才 ブジェク トフ ァイ ルを 別に ⑴总 して おいて、 
あとから それを リンクす る だけで もよ いのでは ないかと 冬え る 人 もい るか もしれ ません が、 
それでは イ ぐ"] ■能な こと も"] •能に する のが コンポーネント ギヤ ラリです 〇 たとえば、 本節で 
作業を 行った スプリット ウィンドウの 作成は、# include 义を揷 人したり、 メンバ 変数を 追 
加したり と、 別 ファイルを〗 丨丨总 して おいて あとから それを リンクす るので は灾现 できない 
作業です 。ところが コンポーネント ギヤ ラリは、 现 心 •: の ソースコードの 状態を 把握して、 
コードを 適切な 形で 抑 入して くれる のです 0 

なお、 コンポーネント ギヤ ラリに も [スプリット バー] なる コンポーネントが 州 意され 
ています が、 これを 本節で 説明した コードを 記述す る 代わりに 使 W する ことは できません 
(残念） 。货は スプリット ウィンドウには 「静的 スプリット バーを 使用す る もの」 と 「動的 ス 
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ブリット バーを 使 川す る もの」 の 2 fRSi があります， そして、 イく 節で 解説した のは 「餅 的ス 
プリ ッ卜 バーを 使 川す る もの」、 コンポーネント として 川 立され ている のは 「勋 的ス プリ ッ 
卜 バーを 使 川す る もの」 という わけで、 コンポーネント ギャ ラリを 使丨丨 j しても あとで コー 
ドの 変 til が 必要になる ことから、 ここでは 丨 1*丨: 接 r •作 袋で スプリット ウィンドウを 作成した 
のです。 

•エクスプローラ スタイル 

での 作 袋は すでに 終えて いると 思います から、 总丨ズ I 的に 解説を 避けて きた 機能を 紹介 
しまし よう 火は AppWizard の 新 機能を 使えば、 本ゥ で 解説した 作 袋の 人 T. を AwWizard 
に 「丨则 的に 行わせる ことができる のです。 SI)I/MI)I 形式の アプリケーションを 作成す る 
場 介、 App Wizard の ステップ 5 で、 [ Windows ェ クス ブロ一 ラス タイル 1 という 選択肢 
が 衣， ji されます。 




図 1-10 Windows エクスプローラ スタイル 



これを 選択す ると、 まさに 本 ••：? で忏 さんが 行った 作 袋が ほぼ そのまま AppWizard によ っ 
て 行われて しまいます つまり、 メインフレーム ウィンドウに スプリット ウィンドウを 塊 
め 込み、 ノ r: の ペインには ツリー ビューを、“ の ペインには 丨丨 TML ビューを それぞれ 川な 
する 作 策が すべて AppWizard によって 「丨勋 化されます。 また、 イ丨 •の ペインに 割り 玛 てる 
ビューに ついては、 CVicw クラスの 派， 1-: クラスから ユーザーが 選択す る ことができます。 

このように 便利な 機能では あります が、 その 内界を 知らなければ 活⑴ する ことは 雖 しい 
ので、 では 利 川せ ずに 沾ま せました。 しかし 卞 成された コードの 内衫 はすで に 水 0 で 
解説し ましたから、 次からは 人い に 利) |j してく ださい 3 
以丨 •.で 本 0 の 解説を 終わりに して、 次な では、 戈 作衮に 人る 前の 準備を さらに 進め、 ま 
たこれ に必 袈 となる 知識を 少 々 f •に 人れ る ことにしましょう。 
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1 寧では、 スケルトンを 作成し、 ビュー クラスを 1 つ 追加、 さらに スプリット ウィンド 
ウを 作成し ましたが、 1 っの アプリケーション として 完成す るまでに は、 まだまだ 足りな 
いものが 山 ほどあります 。ビュー クラスの 操作を メイン ディッシュ として 3 C 以降で 味わ 
うこと にして、 ひとまず 本草では URL リストを 荇理 する ドキュメント クラスを 光に 灾装 
してし まう ことにします。 

ドキュメント クラスの 欠 装 力 •法は すでに 第 3 部の MMView で 解説して いますが、 URL 
マネージャと MM View では 少し だけ 違う 点が あります。 それは、 MM View が 扱う データ 
ファイルが バイナリ 形式であった のに 対して、 UKL マネージャでは テキスト 形式で あると 
いう ことです 。テキスト 形式の データファイルで あっても 、データファイルを 説み |丨1: きす 
るた めに CObject::Serialize 仮想 メンバ 間数を オーバーライドし、 CArchive 才 ブジェク 卜 
を 使 W する 点では 変わりありません が、 CArchive 才 ブジェク 卜の 使 川" 法が W •なります 0 

2.1 データファイルの フォー マツ 卜 

第 4 部の 主役は あとに 控えし ビュー クラスで すが、 ビュー クラスと 対を なす ドキ ュメ ン 
トクラス なくして は ドキュメント一ビュー •アーキテクチャを 使った アプリケーションは 語 
れ ません 。しかし ドキュメント クラスは ここでは あくまでも 脇役です から、 次のように 非 
常に 単純な ものと します。 

•登録で きる URL の 個数は 1 000 件に 限る 
春 URL の 編集は できない 
• URL の 保存は できない 
春 ディレクトリ 階層は 1 段階に 限る 
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上記の 制服を 設ける ことによって、 ドキュメント クラスは かなり ザ •純な ものになります 0 
ドキュメント クラスの 灾装を 始める 前に、 まず lsurl ツールが 作成す る テキスト 形式の 
データファイルの フォーマット について 説明して おき ましよう 。データファイルに 含まれ 
る悄 報には、 



♦フォルダ 名 

• URL と Web ページの タイトル 

の 2ff (類が あります 。さらに、 各 URL が どの フォルダに 含まれて いるの かを 示す 必要 も 
あります。 

リス 卜 2-1 に データファイル 例を 氺 します。 これは、 図 2-1 のように 分鉍 された お ノ メ (に 
人り を lsurl ツールで テキスト ファイルに 変換した ものです。 

\iMzMW 

fcWCA り ■理 ©L 

册 勤) 管 5|( M ) 

すへ ての 供 tt « E 新 (逆 

#]ASCn24-HEADLINE- 

色 ) Welcome to Microsoft's Homepace ?JWELCOME ASCII CORPORATION 

図 2-1 お気に入り 例 



リス 卜 2-1 データファイル 例 
+ASCII 

http://www.ascii.co.jp/ascii24/ASCII24-HEADLINE- 
http://www.ascii.co.jp/ WELCOME ASCII CORPORATION 

http://www.microsoft.com/ Welcome to Microsoft's Homepage 



リス 卜 2-1 を宄頒 から U ていき ましょう。 1 行丨丨 のように、 行 如が 「+」 で 始まって いる 
行は、 ここから フォルダが 始まって いる ことを 味し、 絞く 文字列が フォルダ 名を 炎して 
います。 フォルダ 名の 終端は 行 七で 衣して います。 

次に 2 行 II です が、 これが URL と 対応す る ページ タイトル 义字 列を 衣して います。 URL 
はむ 如から 始まり、 ページ タイトルは 行 未で 終わります。 また、 その K 切れ 丨丨 には 1 文ネ 
の タブ 义 を揷 人して います。 つま 丨 ）、 UKL と ページ タイトルを 含む 行は、 次の 構 
造を しています。 

< 行頭 > CURL 〉 < タブ 文字 >< ページ タイトル >< 行末 > 




2.2 URL 情報の 格納 場所を 用意す る 



3 行 丨丨は 2 行 II と M じく URL を 念む 行です から 飛ばして、 4 行 11 を 兄る と、 「-」 だけが 
穴 まれて います 。これは、 フォルダの 終 广 を 衣して います。 この 例では 1 行 U の 「+ ASCII」 
から 4 行 HI の 「一」 までが、 フォルダ ASCII に 穴 まれて いる ことを 表して いる わけです， な 
お、 URL マネージャでは フォルダの 丨荷 W は 1 段陪 までに 限って いるので 、フォルダの 屮に 
フォルダを 作る ような データは 認めない ことにします。 

次の 5 行 II は M じく URL を 含む 行です が、 4 行 丨丨 で フォルダ ASCII は 終 T している の 
で、 この Microsoft の ホームページへの URL は、 フォルダに 含まれず 、トップレベルに 衣 
示される ことになります。 

以丨 ••を まとめる と 次のようになります 0 

1 •彳 f 如が 「+」 ならば、 フォルダの 開始を 立 味す る 
2 •行頭が 「-」 ならば、 フォルダの 終 r を总 味す る 
3. どちらで もなければ、 URL をズ むむ として 扱う 



2.2 URL 情報の 格納 場所を 用意す る 

それでは、 ドキュメント クラスの 火 装を 始める ことにし ましょう 。ドキュメント クラス 
がす 丨丨 •当す る役沏 は、 第 3 部で 解説した 内衫と 俺 端に 迩う ところはありません 〇 nm のつ も 
りで 説み 進めて ください。 

まず、 データファイルから 説み 込んだ URL リストを 格納す るた めに、 メンバ 変数を ド 
キ ュメ ン トクラスに 迟 加し ます 0 データファイルから 説み 込んだ URL はこれ から 作成す る 
CURLEntry クラスに 格納し、 ドキュメント クラスに はこの CURLEntry クラスの fid 列を 
メンバ 変数と して 追加す る ことにします。 

データファイルには 1 行に つき URL と ページ タイトルが 組になって 格納され ています 
から、 CURLEntry クラスは リス 卜 2-2 のように 設 •汁し ます。 CURLEntry クラスの 定 戒 
は、 この クラスを 使う のは ドキュメント クラス だけです から、 CURLManDoc クラスが 定 
在され ている UKLManDoc.h ファイルの 光如 部分で 行えば よいでしょう。 なお、 URL マ 
ネー ジャ では 第 3 部で 解説した ように、 CObject クラスに よる シリアライズの しくみを 利 
川した ファイルの 説み •丨 f きは 行わない ので、 CURLEntry クラスは 接贱 クラスを 持たない、 
通常の クラスと して 定義して います。 
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リスト 2-2 CURLEntry クラス ⑴ RLManDoc.h) 



class CURLEntry 




CStnng m.strTitle; 

CString m.strURL; 

public: 

CURLEntryO { m^strTitle = ,M, ; m.strURL = 
CURLEntry (CStringft t, CStringft u) { 
m.strTitle = t; m.strURL = u; > 

CStringft getTitleO { return m.strTitle; > 
CStringft getURLO { return m.strURL; } 



CURUintry クラスの メンノ く 変数には、 ii し strTitle メンバ 変数に ページ タイトルが、 
m_strURL に URL が それぞれ 义 7 •列と して 格納され ますが、 フォルダの 悄 報を 格納す 
る坳 介には、 特殊な 义卞 列を セットし ます (> 行頒が 「+」 で 始まる フォルダの 開始を 意味 
する 行を 説み 込んだ ときには、？? •段は UKL が 格納され る m_strURL メンバ 変数に 文字列 
「dir」 を 格納し、 m_strTitle メンバ 変数に フォルダ 名を 格納し ます。 また、 「-」 だけから 
なる フォルダの 終 r を な 味す る 行を 説み 込んだ ときには、 m _ str URL メンバ 変数に 文字列 
[upj を 格納し、 丨 ii_strTitle メンバ 変数には 空文 列を 格納し ます 。つまり、 URL かフ才 
ル ダ悄報 かに かかわらず、 データファイルの 1 行が そのまま 1 つの CURLEntry オブジェ 
ク 卜に 対応す る ことになります。 

以 I •.のように 记義 した CURLEntry クラスの ft! 列を リス 卜 2-3 のように、 CURLManDoc 
クラスの n し arrayUKL メンバ 変数と して 追加し ます。 また、 いくつの 配列 要素を 使った の 
かを 格納す るた めに、 int 沏 の m_nlndex メンバ 変数 も 同時に 追加し ます 0 

リスト 2-3 m_arrayURL メンノ 後 数の 追加 （ URLManDoc.h) 

#define MAX.URL 1000 

// 格納で きる URL の 個数 

class CURLManDoc : public CDocument 

• • • 

//ァトリビュート 

public : 

CURLEntry* m_arrayURL[MAX_URL] ; 

// データファイルから 読み込んだ URL と フォルダ 情報を 格納す る 
mt m.nlndex; 




2.2 URL 情報の 格納 場所を 用意す る 



//m_arrayURL メンバ 変数で 使われて いる 要素 数 

// m_arrayURL メンバ 変数は フォルダ 情報の 格納に も 使われる ので、 

// 格納され ている URL の 個数では ない 




m_arrrayURL メンバ 変数は CURLEntry クラスへの ポインタの 配列です この 列の 
サイズは MAX_UKL として 1000 に) U 衣され ている ので、 これが URL マネージャで 扱え 
る データ サイズの 丨 •.吸と なります 。ところで、 イ の Wi/rt で マネージャが 扱える URL 
の 個数は 1000 個に 眼る と 述べました が、 I ••述 したよう に フォルダ 情報を 格納す るた めに 
も CURLEmry 才ブジ ヱ クトを 使 川す るので、 フォルダ 悄 報が 穴 まれる 坳 介には、 格納で 
きる URL の侧 数は 1000 - フォルダの 例数 x2(|»j 始と終 r で 2 つの CUKLKmry オブジェ 
クトを 侦 川す るた め） になります。 

メンバ 変数を 川 总 したと ころで、 データファイルの 説み 込みを 行う 前に、 m _ array URL 
メンバ 変数の 初 沏 化と 後始 ぶの 処押 •を 光に 火 焚して しまいましょう。 

まず 初期化で すが、 これは CURLManDoc クラスの コンストラクタで 行います。 App 
Wizard によって すでに 卞の コンスト ラク 夕が 川 立され ています から、 リス 卜 2-4 のように 

3 行; II 加して ください 。内界は m_arrayURL メンバ 変数の 配列 要ぶ をす ベて NULL 侦に 
し、 データ 数が 0 である ことを 尔 すため に m_nlndex メンバ 変敉に 0 を 代人す る だけの、 

丨 Wj 中 な ものです。 



リス 卜 2-4 CURLManDoc クラスの コンストラクタ （URLManDoc.cpp) 

CURLManDoc : : CURLManDoc ( ) 

{ 

for (int i = 0; i < MAX_URL; i++) 
m_arrayURL[i] = NULL; 
m.nlndex = 0; 



次に 後始 未 です が、 今度は CURLManDoc::I)eleteContentsf> 乂想 メンバ 関数で 行います 0 
初期化を コンストラクタで 行いながら、 後始 未は デス トラクタで 行わない のは イく思 淡に 
思われる かもしれ ません が、 これには 理 丨丨丨 があります 。第 3 部の MMView のよう な MDI 
アプリケーションな らば ドキュメント クラスの デス トラクタと D e l ete C 〇mem s 似 想 メン 
バ閲 数の どちらに 紀 述 しても かまわな いのです が、 UKL マネージャの ような SD1 アプリ 
ケ一シ ョンでは、 DeleteContentsfe 想 メンバ 閲纹 を灾 装し なければ なりません。 ここで 
は、 SDI アプリケーションに 限って その 理丨 丨丨を 説明し ましょう 0 
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DeleteContents メンバ 問 数は CDocument クラスで 定義され ている 仮想 メンバ 関数で 
す。 この メンバ 丨阳 数は アブリ ケー シ ョンの 終 r 時 や、 [ファイル] - [新規 作成] を 奥行し 
て 編集 中の ドキュメントを クリア するとき など、 ドキュメントの 内祚を 破 衆し なければ 
ならない ときに 呼び出されます。 アプリケーションの 終 r 時には ドキュメント クラスの デ 
ス トラクタ も 呼び出され るので すが、 問題は ドキュメントを 新規 作成した ときです 。こ 
のとき には、 CDocument::DeleteContents 仮想 メンバ 閲数 だけが 呼び出され、 ド キュメ 

ン トクラスの デス トラクタは 呼び出されません。 つまり、 SI ) I アプリケーションでは ア 
プリ ケー シ ョンの 突 行 時に ドキュメント オブジェクトが 作成され 、アプリケーションが 終 
r する まで ずっと この ドキュメント 才 ブジェク 卜が 使い 絞 けられる のです 0 したがって、 

CDocument::DeleteContents 仮想 メンバ 閲 数を 灾装 しなければ、 ドキュメントを 新規 作成 
しても、 A い データが 残った まま 次の 榀 他 作 菜が 始まって しまう という わけです。 

リスト 2-5 に CURLManDoc::DeleteContents 仮想 メンバ 閲 数の 内容を 示します 〇 CURL 
ManDoc::DeleteContents 仮想 メンバ 問 数は ClassWizard または WizardBar を 使って 才一 
バーラ イドし、 CURLManDoc クラスに) li 加して ください 0 



クラス オブジェクト ID メッセージ 

CURLManDoc なし （CURLManDoc を iM 択） ， DeleteContents 

表 2-1 CURLManDoc::DeleteContents 仮想 メンバ M 数を オーバ一ライド する 



CURLManDoc::DeleteContents 仮想 メンノ CM 数 （ URLManDoc.cpp) 



void CURLManDoc: : DeleteContents () 

{ 

//m-arrayURL の 内容を 削除す ると 同時に、 CURLManDoc::CURLManDoc〇 と 
// 同じように、 ドキュメントの 初期化 も 行う 
for (int i = 0; i < m.nlndex; i++) { 
delete m.arrayURL[i] ; 
m.arrayURL[i] = NULL; 



m.nlndex = 0; 

CDocument : : DeleteContents () ; 






2.3 テキス 卜 ファイルを 読み込む 



2_3 テキス 卜 ファイルを 読み込む 

URL 怡 報を 格納す る， 備が 幣っ たので、 仏 •後に テキスト 形式の データファイルを 読み込 
むガ 法に ついて 解説し ましょう。 

MFC が 採 パ丨 している ドキュメント 一 ビュー •アーキテクチャでの ファイルの 人出 力は シ 
リア ライ ズと 呼ばれ、 Serialize 仮想 メンバ 問 数と C Archive クラスが キーと なること はす 
でに 第 3 部で 取り 丨 •.げたと おりです。 ただし、 シリァライズ によって 人出 力を 行う デ一夕 
ファイルは バイナリ 形式の ものである ため、 テキスト 形式の データファイルを 扱う UKL マ 
ネー ジャ では 少し 递った 方法が 必要になります c 
[ファイル]- [問く] など、 ファイルの 人 川 力を 行う メニュー コマンドを 灾行 すると、 COb 
ject::Serialize 仮想 メンバ 問 数が 呼び 川 される ので、 この 仮想 メンバ 閲 数に コードを 追加す る 
点では 変わりありません し、 CArchive クラスを 使う 办 でも M じです。 ただし、 CArchive ク 
ラスの <<演«: f •や〉〉 演筇+ は 使いません 。代わりに 使 州す るの が、 CArchive::ReadString 
メンバ 間数です 。 この メンバ 問 数は データファイルを テキスト 形式と して 扱い、 キャリッジ 
リターン （•¥!*•) と ラインフィード C¥n’） で 衣され る 行 朱までを リ丨 数に 指定され た CString 
喂才 ブジェク 卜に 説み 込みます。 

Bool CArchive::ReadString(CString& rString) 

返り 侦 BOOL 1丨: 花 •終 r すると TRUE、 铒常終 r( EOF を 含む） すると 

FALSE を 返す 

リ丨数 CString& rSMn ぎ rString に 1 行 説み 込まれる 。行末の 改行は 取り除かれる 

CArchive::ReadString 問 数を 使えば、 返り 侦で ファイルの 終端を 調べる ことができます 
から、 細かな エラー ハンドリングを 竹けば、 次の コードで テキストファイルを 1 行ず つ、 
W •後まで 読み込む 処师が 記述で きます。 

CArchive ar; // 初期化 済みと する 

CString line; // データを 技み 込む バッファ として 使う 



while (ar .ReadString(line)) { 

//line に 1 行 分の データが 技み 込まれて いる 

> 

したがって、 あとは 変数 line に 説み 込まれた データを 解析して、 フォルダ 情報 か URL 
情報 かを 判断して、 処理 すれば よい ことになります。 

ファイルの 入出力 処理は CURLManDocxSerialize 仮想 メンバ 関数に 記述し ますが、 わか 
り やすくす るた めに、 データの 説み 込み 叫に 独、 •/: した メンバ 関数を CURLManDoc クラス 



プログラム 作成の 前 準備 



に 追加し ましよう 。名前は CURLManDoc::ReadFavorites メンバ 問 数と して、 次のように 
して 作成して ください。 




図 2-2 CURLManDoc :: ReadFavorites メンバ 閬 数の 作成 

CURLManDoc::ReadFavorites メンバ 問 数の スケルトンが 作成され たら、 リス 卜 2-6 の 
ように コードを 人人; してく ださい。 

リス 卜 2-6 お気に入りを 読み込む ための コード ⑴ RLManDoc . cpp ) 

void CURLManDoc : : Serialize (CArchivefc ar) 

{ 

if (ar . IsStoringO ) 

// TODO: この 位！ * に 保存 用の コ 一 K を 追加して ください 

> 

else 

ReadFavorites(ar) ; 



void CURLManDoc : : ReadFavorites(CArchive& ar) 

{ 

CString line; "テ一 タ 技み 込み 用 バッファ 
CString url; // line から 抜き出した URL を 格納す る 
CString title; //line から 抜き出した ページ タイトルを 格納す る 

int pos; 

while (ar.ReadString(line) && m_nlndex く MAX-URL) { 
if (line [0] ==，+，） { 

// ディレクトリの 開始 

title = line.Mid(l, line .GetLengthO - 1); 
m_arrayURL [m_nlndex++] = 

new CURLEntry (title, CStringC'dir") ) ; 

> else if (line[0] == { 

// ディレクトリの 終了 
m.arrayURL [m_nlndex++] = 

new CURLEntry (CString (■•••), CString ("up")); 




2.3 テキス 卜 ファイルを 読み込む 



} else if ((pos = line.Find( ， Yt ，）） ！ = -1) { 

//URL 

url = line • Left (pos) ; 

title = line.Mid(pos + 1, line .GetLengthO - pos - 1); 
m.arrayURL [m.nlndex++] = 
new CURLEntry( title, url); 




CURLManDoc::ReadFavorites メンバ 丨 Kl 数での 処坪は ほとんどが 丨 jl 純な 交 卞 列 操作に す 
ぎません 〇 CArchive::ReadString メンバ 閲 数で 説み 込んだ 1 行 分の 文卞列 データから 必要 
な 部分を 切り出し、 新規に 作成した CURLEntry オブジェクト へと 格納して いる だけです。 

こうして n し arrayURL メンバ 変数に 格納され た データが どのように ツリー ビュー コン 
卜 ロールへ と 反映され るの か、 それは CUKI/1'reeView クラスの 戈 装になります から、 こ 
れで ドキュメント クラスの 解説は 終わりです 。ム i •後に、 ここで 使われて いる CString クラ 
スの メンバ 間数を まとめて おきましょう 0 



TCHAR CString :: operatorQ(int nlndex ) 

返り 侦 TCHAR n / ncfec に 指 走した 位 阶 の 文卞を 返す 

リ丨数 intn/ndex 义 7 列の 中から 取り出す 义卞の 位胙を 0 から 始まる イン デック 

スで指 走す る 



int CString :: GetLength 〇 

返り 侦 int 文卞 列の 从 さを 返す。 中. 位は バイト 



CString CString :: Mid(int nFirst , int nCount ) 

返り 侦 CString リ丨 数で 指定した 範丨 用の 义卞 列を 返す 

引数 int 抜き出す 範 I 用の 先頭 位 沢を 0 から 始まる インデックスで 指定す る 

int nCount nF / W で 指定した •から 抜き出す 义卞 列の M さを バイト 中 •位 

で 指定す る 



CString CString :: Left(int nCount ) 

返り 侦 CString リ丨 数で 指定した 範 州の 义卞 列を 返す 

引数 int AiCoaW 文字列の 先頭から nCount 义卞数 だけ 取り出す 



ツリー ビュー コン 卜 ロールを 
使って みよう 



さて、 いよいよ URL マネージ ャの丨 ir •である ツリー ビュー コントロールの 解説を 始め ま 
す。 ツリー ビュー コントロールは エクスプローラ 、コントロール パネルの システム アブレ ツ 
卜を はじめと して、 Windows 95 以降では いたるところで 使われて いる コントロールです 
(図 3-1>〇 データを ただ ズラズ ラと •列に# •べるのに 比べて、 陪 的 的に データを まとめる 

ことができる ツリー ビュー コントロールは わかりやすい ユーザー イン 夕 一 フェイスを ユー 
ザ 一に 提供で きる、 応用 砘 I 用の 広い コントロールです 




図 3-1 ツリー ビュー コン 卜 □一 ル 



本な では UKL マネージ ャ のん 側の ペインに 剖り 当てられる、 CURLTreeView クラスを 
題材に して、 ツリー ビュー コントロールの 使い方に ついて 解説し ます。 

ところで 第 4 部の 曾 頭で も 述べた ように、 ツリー ビュー コントロールの 使い 力 •は 複雑で 
あるた め、 DDX を 使った 操作は 行いません。 したがって、 本 穿では l)I)X という 言您は 
いっさい 赍場 しません。 MFC を 使った Windows プログラミングと いうと、 DDX を 使え 
ばよ いと 考える かもしれ ません が、 それだけでは できない こと も 数多く# 在す るので す。 
DDX を 使わずに、 特定の コン 卜 ロールを 細かく 制御す る 方法を 感じ取って くだ $ い。 



3 ツリー ビュー コン 卜 □一 ルを 使って みよう 



3.1 ツリー ビュー コン 卜 □一 ルの 機能 

ッリー ビュー コントロールを おおざっぱに 説明 すれば、 「拡张 リスト ボックス コント ロー 
ル」 といった ところで しょう 。アイテムを リストアップして、 そこから アイテムを 選択し 
て …… 、という ューザー インターフェイスを 作る 丨丨 的に 変わりはありません 。どの あたり 
が 「拡張」 されて いるかと いうと、 次の 3 戍が あげられます。 

•アイテムを 階層 化して 表示で きる 

ッリー コントロールの 名前が ボ すよう に、 アイテムを ツリー 状に 衣, P する ことができ 
ます 。リスト ボックスを ファイル しか 作れない ファイルシステムに 例えれば、 ツリー 
コン 卜 ロールでは フォルダを 作れる ようになった という ことです。 この フォルダに 相 
4 する アイテムを ダブル クリック する ことによって、 それよりも 深い 附 W に 位 阶 する 
アイテムを 衣/ j i したり、 R 3 •したりす る ことができます。 

•アイテム ごとに ビットマップを 割り当て、 文字列の 前に 表示で きる 

リスト ボックスでは 义卞 列し か 衣/〗 i する ことができず 、ビットマップ などを 衣ボ した 
ければ オーナー ドローと 呼ばれる テクニックを 使わなければ なりませんでした。 これ 
は 丨(丨丨 倒な 作 菜でした が、 ッリー ビューは、 文字列と M 時に ビットマップを 衣 示す るで 
きる ので、 簡 中. に ビットマップを 衣ポ できます 。ビットマップは アイテム ごとに 代な っ 
たものを 指定で きます し、 選択され ている 選択され ていない など、 状態に 応じて 衣 
示す る ビットマップを 複数 使 川す る こと もで きます。 

•ドラッグ & ドロップの サボー 卜 

ッリー ビュー コントロールには アイテムを ドラッグ & ドロップ によって 操作す る 機能 
があります。 ただし、 本# では 扱いません。 

こうした 機能を 利) | j する ためには、 いくつかの ステップを 踏んで ッリー ビュー コント ロー 
ルを 挽 作す る必 •思が あります 。まず アイテム を揷 人す る 前に、 必敗 に応じて 次の 2 つの 初 
期 化 処理を 行って おきます。 

•ツリー ビュー コントロールの スタイルの •没 走 

•各 アイテムの ノ r : 側に 衣 示す る ビットマップの 渾備 （イメージ リストの 作成） 

ッリー ビューに ビットマップを 表示し ない 場 介には この 作 袋は 不要です。 

初期化 処邱 •を 行う と、 アイテムを ッリー ビュー コントロールに 分録 できる ようになり ま 
す。 アイテムを 赍録 したら、 今度は アプリケーションの ューザーが ッリー ビュー コント ロー 
ルを 操作 できるようになるので、 マウスの クリック などの 処理を 考 通; する ようにし なけれ 
ばな りません。 




3.2 初期化 1 : ツリー ビュー コン 卜 ロールの スタイルを 設定す る 



卞く t では、 これらの 処理を 順を 沿って 解説して いきます。 まずは 上述の 2 つの 初期化 処 
师のガ 法に ついて 。ついで アイテム の炫鉍 のれ •力 •〇 Ai 後に ユーザーが アイテムを クリック 
したと きの 処 坪 ノア 法に ついて 解説し ます 0 

3.2 初期化 1: 

ツリー ビュー コン 卜 ロールの スタイルを 設定す る 



ツリー ビュー コントロールには、 表 3-1 および 図 3-2 に， すよう な スタイルを 设记 する 
ことによって、 兄せ" や 機能を カスタマイズで きます。 



スタイル 


効果 


TVS_HASLINES 


親 アイテムと 子 アイテムを 結ぶ 線が 引かれる 


TVS 丄 INESATROOT 


K 上位 階層に 位 S する アイテム 同士を 結ぶ 線が 引かれる 


TVS.HASBUTTONS 

■ 一 一^^— ■ ■ — — ^ ■ ■ 1 


子 アイテムを 持つ アイテムの 前に ボタンが 表示され る 


TVS—EDITLABELS 


各 アイテムの ラベルを « m 可能に する 



表 3-1 ツリー ビュー コン 卜 ロールの スタイル 



TVS LINESATROOT 
TVS HASBUTTONS 



_J Root lt«m 1 
_J Root l»#m 2 
Ijl. _J Child l««m 2 




TVS EDITLABELS 
TVS HASLINE 



図 3-2 ツリー ビュー コン 卜 □一 ルの スタイル 

デフ ォルトの 状態では 何の スタイル も 指定され ていないので、 アイテム （义卞 列） だけが 衣 , ji 
される という、 ちょっと お 寒い 状態です。 少なくとも TVSJiASLINKS と TVSJIASBin 、 
TONS は 设记 して おくと よいで しょう 。ただし、 これらの スタイルには 次の 依存 閲 係が あ 
る ことに 注 总 してく ださい。 

• TVSJIASLINES がない と TVS_LINESATKO()T は 機能し ない 

• TVS_LINESATROOT がない と 以 h 位陪 的 の アイテムには ボタンが 表示され ない 
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つまり、 TVS—UNESATROOT を 設定 するとき には TVS_HASLINES を、 TVS_HAS 
BUTTONS を 設定 するとき には TVS_LINESATROOT を それぞれ かならず 設定す る必 
要が あります。 

これら ツリー ビュー コントロールの スタイルを 設定す るには、 CWnd::PreCreateWindow 
仮想 メンバ 間数を オーバーライド します 。これは 通常の ウィンドウ スタイルを 設记 する 方 
法と M じです。 灾際 には、 ウィンドウ であれば どのような もので も PreCreateWindow 仮 
想 メンバ 問 数を 才ー バーラ イドす る ことによって、 ウィンドウ スタイル （ \VS_〜> を 没 记で 
きる ようになって います。 

CWnd::PreCreateWindow 仮想 メンバ 関数は ウィンドウが 作成され る、 J •前に フレーム ワー 
ク によって 呼び出される 関数です。 その リ丨 数には ウィンドウを 作成す るた めに 川 いられる パ 
ラメ 一夕が 含まれて いるので、 PreCreateWindow 仮想 メンバ 閲 数を オーバーライドして 引 
数の 侦を 変 1 ii する ことによって、 デフ オルトの 状態 （の ウインドウ スタイル や ウィンド ウサ 
イズ など） とは 異なる ウインドウを 作る ことが 可能になります 〇 CWnd::PreCreateWindow 
メンバ 関数の 丨丨 f 式は 次の ような ものです 0 



BOOL CWnd::PreCreateWindow(CREATESTRUCT& cs ) 



返り 侦 BOOL ウインドウの 作成を 琳: 絞す る垛 介には 0 以外、 屮丨丨 •.す 

る 場合には 0 

リ丨 数 CREATESTRUCT&cs ウインドウを 作成す るのに 必要な パラメータ 

PreCreateWindow W 数には CREATESTRUCT& 喂の 引数 cs が 渡される ので、 今 述べ 
たように PreCreateWindow 閲数 内で cs を 操作す る ことで 窄 みの ウインドウ スタイルを 
設逛 する ことができます 〇 CREATESTRUCT 構造体の メンバ 変数の 一部を 表 3-2 に 示し 
ます 。これ 以外の メンバに ついては、 フレームワークの 内部を 詳しく 刊! 解す るまでは でを 
付けない 方が 1 不明でしょう。 



型 


メンバ 変数 名 


用途 


int 


cy 


ウィンドウ サイズ （縦） 


int 


CX 

U — ■ ■■ —^^^^^^^^^^^^^^^^^^ 


ウィンドウ サイズ (横） 


int 


y 


ウィンドウの 表示 位 »(Y 軸） 


int 


X 


ウィンドウの 表示 位置 (X 軸〉 


LONG 


style 

•丨 ■— ■ . 


ウインドウ スタイル 


LPCSTR 


1 

IpszName 


ウィンドウの 名前 


LPCSTR 


IpszClass 


ウィンドウ クラスの 名前 


DWORD 


dwExStyle 


ウィンドウ 拡張 スタイル 



表 3-2 CREATESTRUCT 構造体の メンバ 
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ここでは ウィンドウ スタイルを 変更した いので 、 style メンバ 変数を 書き換える こと 
にします。 CURLTreeView :: PreCreate Window 仮想 メンバ _ 数は すでに App Wizard に 
よって 作成され ています から、 リス 卜 3-1 で アミが かかって いる 行を 追加す る だけで スタ 
イ ルを 設走 できます。 URL マネージャでは TVS — HASLINES 、 TVS _ LINESATROOT 、 
TVS _ H ASBUTTONS の 3 つの スタイルを 設定して います。 

リス 卜 3-1 ウィンドウ スタイルの 投定 （ FriendTreeView . cpp ) 

BOOL CURLTreeView: :PreCreateWindow(CREATESTRUCT& cs) 

{ 

cs. style |= (TVS.HASLINES I TVS.LINESATROOT I TVS_HASBUTTONS) ; 

//3 つの スタイルを 追加す る 

return CTreeView: :PreCreateWindow(cs) ; 



ウィンドウ スタイルを 設定す るには、 リス 卜 3-1 で 行って いるよう に 必要な スタイルを 
論 PR 和で 結び、 さらに cs.style に, 論理和で 加える ようにして ください。 

3.3 初期化 2: ビッ卜 マップの 準備 

ツリー ビュー コントロールの R た 目は スタイル だけでは なく、 ビットマップに よっても 
ガラッと 変わります 。アイテムの 左側に ビットマップを •衣 示す るか どうかは スタイルでは 
なく、 あとで 述べる ように、 アイテムを 挿入 するとき の パラメータ によって 決まります 0 
つまり、 ビットマップの 表示、 非 表示は ツリー ビュー コントロール 全体に 対する 設 走では 
なく、 各 アイテム に対する 設定です。 また アイテム ごとに R •なる ビットマップを 指定す る 
こと もで きます。 

ビットマップを ツリー ビュー コントロールに 登録す るには、 以下のような 作業が 必要に 
なります。 

1. ビットマップ リソースの 用意 

2. イメージ リスト オブジェクトの 用意 

3. ビットマップを イメージ リストに 登録す る 

4. イメージ リストを ツリー ビュー コン 卜 ロ一ルに 登録す る 

MFC には ビットマップを 扱う クラスと して CBitmap クラスが あります が、 ツリー ビュー 
コントロールでは 複数の ビットマップを 配列の ような 形で まとめて 扱う ことができる イ メー 
ジリ ストと いう ものを 使用し ます。 ツリー ビュー コントロールでは、 多くの場合 アイテム 
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ごと や アイテムの 状態 （選択され ている かが か、 フォルダが 展開され ている かれ かな ど） ご 
とに ビットマップを 使い分ける ことになるので、 複数の ビットマップを まとめて 竹 押で き 
ると 便利 だからです。 イメージ リストを 扱うた めの クラスと しては、 ClmagcList クラス 
が 川 立され ています。 



イメージ リス 卜 ツリー ビュー 




図 3-3 ツリー ビューが イメージ リス 卜を© 照 



CImageList クラスには さまざまな 機能が あります が、 ツリー ビュー コン 卜 ロールと 糾 
み 介 わせて 使う 分には、 「ビットマップを まとめて 众鉍 して おき、 それらを 屺 列を 参照す 
るよう に 取り 川して 使う」 と 押 •解して おけば よいでしょう （図 3 - 3) 。ツリー ビュー コント 
ロールに アイテムを 抑 人 するとき には、 ラベルに 使う 义卞 列と 卜丨丨 ゆに イメージ リスト （ビッ 
卜 マップの fill 列） への インデックスを 指记 します。 すると、 あとは ツリー ビュー コン 卜 ロー 
ルが 勝 T •に 义卞 列と 指定され た ビットマップを 衣, ji して くれる のです。 

それでは、 丨 ••にあげた 作衮を (を 追って U ていく ことにしましょう。 

•ビッ 卜 マップの 用意 

URL マネージ ャ では 1 つの アイテム にっき、 選択状態 非 選択状態に 対 丨え; する 2 つの 
ビット マッ ブを 使います。 UKL マネージャでは URL 情報と フォルダの 2 神: 鋇の アイテム 
を 使う ので、 介 ,け4 つの ビットマップを 丨 丨丨总 します 0 4 つの ビットマップには 図 3-4 に/ 
す リソース ID を 指定して、 リソース ェディタを 使って 作成し ます。 

以丨 •• 4 つの ビット マッ プリ ソースは 付 妬 CD-ROM に 川 立して あるので、 これを インポ 一 
ト して、 URL マネージ ャの プロジェクトに 組み込む ことにし ましょう。 これは 他の プ ロジェ 
ク 卜で 作った リソースを 使い M すと きに 利〗 | j できる テクニックです。 

リソースを インポートす るた めには、 プロジェクト ワーク スペースからは アクセスで 尧 
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IOB_FOLDERCLOSE 
IDB FOLDEROPEN 




IDB.URLCLOSE 



IDB URLOPEN 



図 3-4 作成す る リソース とその リソース ID 



ない、 別の プロジェクトで 符理 されて いる ファイルを アクセスし なければ なりません 。こう 
した ファイルに アクセスす るた めには、 ファイル オーブン ダイアログ ボックスから 必要な 
ファイルを®: 接 指定す る 必要が あります 。そのためには 、プロジェクトの 中で どの ファイル 
が リソースを 符理 する ために 使われて いるの かを 知る 必要が あります 。第 1 部で ブ ロジェ 
ク 卜を 構成して いる ファイルの 紹介を 簡中 .にしました が、 そこで 述べた ように リソースに 
間して は リソース スクリプト ファイル （〜 .re) に 保存され ています 〇 AppWizard を 使って 
プロジェクトを 生成した 場合には、 「< プロジェクト 名 >. rc 」 という 名前の リソース スクリ 
プ卜フ ァイ ルが 生成され、 ここに プロジェクトで 使用す る リソースの 定義が 記述され るよ 
うに なって います。 たとえば、 URLMan という 名前の プロジェクト だったら、 URLMan.rc 
という リソース スクリプト ファイルが 生成され る わけです。 

それでは URL マネージャに 必要な リソースを 追加す る ことにしましょう 。付诚 CD-ROM 
で 提供して いる 「URLMan¥Resource」 フォルダには resource.rc という ファイルが パ さ 
れ ています。 この フォルダには Resource という 架空の プロジェクトが ある ものと して、 
URL マネージ ャに 必要な ビットマップ リソースが あらかじめ すべて 用意され ています。 こ 
こから リソースを コビーす る ことによって、 一気に 必要な リソースを 作って しまい ま しょ 
う （CD-ROM の 中身は あらかじめ ハ一ド ディスクに コビーして おく ことを お勧めし ます）。 

まず メニューから [ファイル] 一 [開く] を 突 行して、 先に 述べた フォルダから Resource.rc 
を 開いて くた さい 0 すると、 ワーク スペース ウィンドウの [ResourceView ] ページと よく 
似た ウィンドウが 開きます （図 3-5>。 

次に プロ シェ ク トワ一 クス ペースに [ResourceView] ページを 表示して ください 。あと 
の 作業は 簡単です 。エクスプローラで ファイルを コピーす るよう に、 R esource . rc のリ ソー 
スウ ィン ドウから、 リソースを 1 つ 1 つ ドラッグして プロジェクト ワーク スペース ウィン 




ン卜 □一 ルを 使って みよう 




> _J Accelerator 
S 」 Bitmap 

A _J D«lo< 

> _ | Icon 

> _J Merxi 

♦ 一 | String Table 
♦ 」Toobar 

♦ I Version 



図 3-5 リソース ウインドウ 



けで リソースの コピーが Vcir します。 このと き 
D を 押した ままに して おいてく ださい 。離した まま ドロップ すると コビーでは メ 
: なって しまいます。 

ource.rc ファイルに 格納され ている 4 つの ビットマップ リソースを コピーし 尺 
マップの 作成は 終 r です。 

* 一が 終 r したら、 シンボル ブラウザで 各 ビットマップに 刎り 当てられ ている リ 
を 確 •忍して みて ください 。メニューの [衣 示]- [シンボル ブラウザ] を 奥行す る 
f ル ブラウザが 表示され ます （図 3-6> 〇 




次の！ T/- スで » 用 




図 3-6 シンボル ブラウザ 



，た 今 コビーに よって 作成した IDB_FOLDI£KCLOSE に 始まる 4 つの リソース I 
:、 嵛り •が 連続して いる ことが わかります。 イメージ リストに 赍録 する ビット マ 
-スの リソース ID の 侦が迚 続して いれば、 ビットマップの 分 録を取 純な ループ 
セる ため、 意識的に 畨兮 付けを 行って います 〇 Developer Studio で 作成した リソ 
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の リソース ID の侦 は、 1 つ 作成す る ごとに 1 埘加 していく ので、 必要な 数 だけ 先に ビット 
マップを 作成して リソース ID を 確保し、 それから デザインを 行う とよいで しょう。 



籲ビッ 卜 マップの 登録 

ツリー ビュー コントロールで 使う イメージ リストの 作成は、 ツリー ビュー コントロール 
に アイテムを 揷人 する 前に 行わなければ ならない ので、 通常は CView :: OnInitialUpdate 仮 
想 メンバ 間数を 才ー バーラ イドして、 そこで 行います 〇 CView :: 0 丨 II 丨 litialUpdate 仮想 メン 
バ間 数は、 CView :: 0 丨 iDraw メンバ 閲 数が 初めて 呼び出される 丨 W に 呼び出される メンバ 丨幻 
数です から、 衣示閲 係の 初期化を 行う のに 適して います。 ただし、 SDI アプリケーション 
の垛 介には、 [ファイル]- [新規 作成] や [ファイル]- [開く] などを 次 行して、 ドキュ 
メント の 初期化を 行った 場 介に も 呼び出され るので、 この 人 •.( を芩丨 返す る必 货 はあります。 

CURLTreeView::OnInitialUpdate 仮想 メンバ IRI 数 もやは り AppWizard によって すで 
に 作成され ている ので、 リス 卜 3-2 にポす コードを •丨! : き 加えて ください 。また CURLTree 
View クラスに ClmageList クラスへの ポインタを 追加す るの も 忘れないで ください （リス 
卜 3-3>〇 メンバ 変数の 追加は、： T 作 菜で 行っても かまいませんし、 ワーク スペース ウィン 
ドウを イ 丨 •クリックして 、ショートカット メニューから [変数の 追加] を 選択す る T •段を 使っ 
て も かまいません 。さらに、 CURLTreeView::m_pImag：eList メンバ 変数の 初期化と 後始 
未を する ために、 リス 卜 3-4 に ホす ように、 CURLTreeView クラスの コンスト ラク 夕と 
デス トラクタに コードを 逍 加して ください。 

リス 卜 3-2 CURLTreeView::OnlnitialUpdate メンバ 間数 （ URLTreeView . cpp ) 

void CURLTreeView: :OnInitialUpdate() 

{ 

CTreeCtrl& treeCtrl = GetTreeCtrlO ; 



if Cm.pImageList == NULL) { 

CBitmap bitmap; 

m_pImageList = new CImageList; 
m_pImageList->Create(16, 16, TRUE, 4, 2); 
for (int i = 0; i < 4; i++) { 
bitmap. LoadBitmap(IDB_FOLDERCLOSE + i) ; 
m_pImageList->Add(&bitmap, RGB(0x80, 0x00, 0x00)); 
bitmap . DeleteOb j ect ( ) ; 

> 

treeCtrl . SetlmageList (m.pImageList , TVSIL.NORMAL) ; 

> 

CTreeView: : OnlnitialUpdateO ; 
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リス 卜 3-3 メンノ 深 数の 追加 （ URLTreeView . h ) 



class CURLTreeView : public CTreeView 

{ 

• • • 

public: 

CImageList* m.pImageList ; 

• • • 

リス 卜 3-4 m_plmageList メンノ 落 数の 初期化と 後始末 （ URLTreeView . cpp ) 



CURLTreeView: : CURLTreeView () 
m.pImageList = NULL; 



CURLTreeView: r CURLTreeView () 

{ 

delete m.pImageList ; 

} 



では、 CURLTreeView::OnInitiaUJpdate 閲 数の 中身を 順を 追って 説明し ましょう。 



ツリー コン 卜 ロールの 取得 

OnlnitialUpdate 閲 数では、 最初に 

CTreeCtrlft treeCtrl = GetTreeCtrlO ; 

を爽 行して、 ッリー コント ロ一ル （CTreeCtrl クラス） の オブジェクトを 取得して います。 
ツリー コン 卜 ロールは エディッ 卜 ボックス や リス 卜 ボックス などと 叫 じ コント ロ-ルの 1 

神: で、 CTreeView クラスの ほとんどの 機能を 賄って います。 实際 CTreeView クラスは メ 
ンバ閲 数を ほとんど 持たず （コンストラクタと GetTreeCtrl メンバ _ 数 だけ）、 CView ク 
ラスと CTreeCtrl クラス （ツリー コントロール） を 中. 純に 糾み 合わせた だけの クラスです 0 
したがつ て、 CTreeView クラスの 派生 クラスでは、 何を する にもまず は CTreeCtr 丨才ブ 
ジェク 卜を 取得す る ことから 始める のです。 

イメージ リス 卜の 作成 

ツリー ビ ユー コントロール 才 ブジェク 卜を 取得したら、 次に イメージ リストを 作成す る 
ために 

m.pImageList = new CImageList 

m-pImageList->Create(16, 16, TRUE, 4, 2); 





3.3 初期化 2 : ビッ卜 マップの 準備 



という 2 行を 火 行し ます 。イメージ リストは、 MFC の 多くの クラスで 见られ るよう に、 2 
つの ステップを 経て 作成し ます。 まず、 コンストラクタを 起動して ClmageList オブジェ 
ク 卜を 作成し、 次に CImageList::Create メンバ 閲 数を 呼び出して 、ビットマップを 登録す 
るた めの 粕を丨 丨丨总 します 〇 これら CImageList::Create メンバ 閲 数の •丨! : 式は 次のようにな っ 
ています。 



BOOL ClmageList::Create(int cx. int cy. BOOL bMask. int nlnitial. int nGroiv) 



返り 侦 BOOL 

•} I Sc int cx 




BOOL bMask 
int nlnitial 
int nGrow 



成功 すれば TRUE、 ' 人 •敗 すれば FALSE 

分 鉍 する ビットマップの 幅 
赍鉍 する ビットマップの “ さ 
ビットマップが マスクを 持つならば TRUE 
初期 状態での 分鉍 "J* 能な ビットマップの 個数の 丨 •.限 
I ••吸 f|f (を 超えて ビットマップを® 録 したと きに 埘加 する 赍録領 
域の 数 



ここでは 16x16 の ビットマップを 4 つ«鉍 する ので、 「cx = cy = 16、 nlnitial = 4」 
としてい ます。 URL マネージャでは 公 初に/! つの ビットマップを 夺鉍 する だけで、 それ 以 
丨 •.の ビットマップを 众鉍 する ことはありません が、 {反に すると すれば 2 つの ビットマップ 
を 紐に して （迸択 時と 非 迸 択峙の もの） «鉍 する ことになるので、 「nGrow = 2J としてい 
ます。 なお 後述し ますが、 ビットマップには マスクを 使う ので、 「bMask = 丁 KUE」 とし 
ています。 



ビッ卜 マップの イメージ リス 卜への 登録 

イメージ リストを 作成したら、 次に さきほど 川 总 した ビットマップを イメージ リストに 
追加し ます。 

for (int i = 0; i < 4; i++) { 

bitmap . LoadBi tmap ( IDB.FOLDERCLOSE + i) ; 
m.pImageList->Add(&bitmap, RGB(0x80, 0x00, 0x00)); 
bitmap. DeleteObjectO ; 

} 

ここでは 4 N ループを M して、 4 個の ビットマップを イメージ リス 卜に 發鉍 しています 0 

これには、 まず CBitmap::LoadBitmap メンバ 丨妈 数で ビットマップ リソースを 1 つ bitmap 
才 ブジェク トに説 み 込んで、 次に CImageList::Add メンバ 丨对 数で、 説み 込んだ ビット マッ 
プを イメージ リストに 众鉍 し、 以後に bitmap オブジェクトに 読み込んだ ビットマップを 

CBitmapd)eleteObject メンバ 関数を 呼び出して 削除 するとい う 手順を 踏みます。 cimage 
List::Add メンバ 関数の ぶ: 式は 次のように なって います 0 




int ClmageList::Add(CBitmap* pbmlmage, COLORREF crMask) 



返り 値 int 成功 すれば イメージ リストへの インデックス （〇 から 始 

まる）、 失敗 すれば- 1 

引数 CBitmap* p6m/ma ぎ e 登録す る ビットマップ オブジェクトへの ポインタ 

COLORREF crMask マスクに 使う 色を 指定 

CImageList::Add メンバ 関数の crMask 引数の 役割は、 登録す る ビットマップの 中で 使っ 
ている 色から、 透明 色と して 扱う 色を 宣言す る ことです 。ビットマップは 常に 矩形です か 
ら 、これを 描丨由 j すると 竹说 によらず 必ず 矩形 領域が ビットマップで 飨 りっぶ されて しまい 
ます 。たとえば 10円 硬貨の ビットマップを 作り、 硬 竹の 中身 だけを 描 _ •したいと しま しょ 
う。 このと き硬货 の 外側は 必要ない のです が、 ビットマップは 必ず 妬 形です から、 とりあえ 
ず 外側は 暗 赤で 飱り っぶします。 これを 単純に 描_ すると 外側の 暗 赤の 部分 も 暗 赤と して 
描 闸 されて しまう わけです 。そこで イメージ リストでは 透明 色を 擬似 的に 作る ことによ っ 
て、 硬 W の 部分 だけを 描 丨由丨 •できる ようにして いるので す。 マスクを 指定した ビットマップ 
を 描丨由 I すると、 ビットマップの 中から crMask に 指 屯した 色の 部分を 抜かして 描丨由 | •され ま 

す 〇 crMask に RGB (0x80. 0x00. 0x00) を 指定して おけば、 さっきの 10円 硬貨 も 余計な 

暗 赤の 外柞が 描 [由 i されずに 済む という わけです。 

crMask に 指 走す る 色は、 たまたま URL マネージャでは 喑 赤を 使って いますが 、ビット 
マッ ブの 中の 描 丨由丨 •されたい 简 所では 使われて いない 色なら ば、 何 色で も かまいません。 ビッ 
トマ ッブの 編 染屮は マスクに 使う 色が 透明では なく、 本来の 色で 衣 示されて しまい ますが、 
アブリ ケー シ ヨンで 描丨由 j するとき には ちゃんと 透明になります。 

なお イメージ リストには アイコンを 登録す る こと もで きます が、 アイコン リソースには 
もともと 「透明 色」 を 指定で きる ようになって いるので、 ブロ グラム 中で マスクの 指定を す 
る 必要はありません 。そのかわり、 アイコン リソースを 作る 段階で 忘れずに 透明 色を 決め 
て 作業し なければ なりません。 

イメージ リス 卜の ツリー コン 卜 □一 ルへの 登録 

イメージ リストの 作成が 終わったら、 

treeCtrl . Set ImageList (m_pImageList , TVSIL.NORMAL) ; 

として、 CTreeCtrl::SetImageList メンバ 閲 数を 使って ツリー コント 口一ルに イメージ リ 
ストを 登録し ます 〇 CTreeCtrl::SetImageList メンバ 関数は 次の ような 関数です。 




3.4 ツリー ビューへの アイテムの 挿入 



ClmageList* CTreeCtrl::SetlmageList(ClmageList* plmageList , int nlmageListType ) 



返り 侦 ClmageList* ツリー コントロールに 登録され ていた イメージ リス 

ト （なければ NULU 

リ丨数 ClmageList* p/mageL 以 登録す る イメージ リスト 

int nlmageListType TVSIL _ NORM AL 、 または TVSIL_STATE を 指定 

nlmageListType には TVSIL — NORMAL または TVSIUSTATE を 指定で きます が、 
選択/非 選択の 2 っの 状態に 応じて 表示す る ビットマップを 切り 荇 える ときには、 TVSIL _ 
NORMAL を 指定し ます。 この場合は 選択され ている かどう かや、 状態に 応じて 利坩 する 
ビットマップ など、 すべてを コントロールが fi 動的に 処理して くれます。 それ 以外の 使い 
力 •を するとき には、 TVSIL _ STATE を 指定して、 アイテムの 状態の 荇理や ビットマップ 
の 使い分けに ついての コードを 追加す る 必要が あります。 たとえば、 HTML ヘルプの 左側 
の ペインに ある ツリー ビュー コントロールでは、； fill の 選択/非 選択では なく、 ドの 附 的 
が M 開され て见 える ようになって いるか どうかで ビットマップの 切り 荇 えを 行って います。 

以 I •.の 作 米で イメージ リストの «鉍 は 終了です 。これで、 ツリー ビュー コントロールに 
アイテムを 分 鉍 する ための 嵊 備が牿 いました から、 次 節では これを 行うた めの コードに つ 
いて 解説を する ことにし ましよう。 

3.4 ツリー ビューへの アイテムの 挿入 

URL マネージャでは、 ツリー ビューに 1 つ だけ 「お 気に 人り」 という アイテムを 揷 人し 
た 状態で 起動し ます 。そこで、 ここでは 「お铽 に 人り」 という ラベルを 持つ アイテムを 挿入 
する 乎 順を 例に 取りながら、 ツリー ビュ 一へ ^ の アイテムの 揷人 方法を 解説し ましょう 0 

ツリー ビューに アイテムを 揷 人す るには 以 ドの 手順を 蹐 みます。 

1. TV _ INSERTSTRUCT 構造体の オブジェクトに 揷人 する アイテムの 情報を 設定す る 

2. ツリー ビューへ アイテムを 揷人 する • 

• T V J N S E RTST R U CT 構造体 

ツリー コントロールに アイテムを 發録 するとき には、 tv _ insertstruct 構造体を 
使います。 TV - INSERTSTRUCT 構造体の 中には さらに TV JTEM 構造体が 含まれて い 
て、 アイテムに 閲 する パラメ 一夕は すべて こちらに 含まれて います。 TV _ ITEM 構造体 
は アイテムの 揷人 以外に も 多くの 場丨 〖丨丨 で 使われる ために、 このような ニ 歌 構造に なって い 
ます。 
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typedef struct _TV_INSERTSTRUCT { 

HTREEITEM hParent; // hParent と hlnsertAfter で 

HTREEITEM hlnsertAfter; // 挿入 位 S を 指定 

TV. ITEM item; // 挿入す る アイテムの 内容 

} TV.INSERTSTRUCT; 

ツリー ビ ュー コン 卜 ロールの アイテムは ツリー 状の 階的偁 造を 持って いるので、 アイ テ 
ムを挿 人す る 位 时 は、 リス 卜 ボックス のように 光頒 からの インデックスを 指 足す る だけで 
は 決まりません 。そこで、 インデックスの 代わりに、 hp arem メンバ 変数で 親/. 閲 係を 指 
定 し、 さらに hlnsertAfter メンバ 変数に よって 叫 じ 親を 持つ アイテム （兄弟： Sibling) IHJ 
での 位 K を指记 します。 

hParent に 指 走す る ハンドルは、 あとで 解説す る CTreeCtrklnsertltem メンバ 丨对 数 （新 

アイテムを 抑 人す る） や CTreeCtrl::GetSelectedItem メンバ 関数 （迸択 されて いる アイ 
テムを 取得す る） などを 使って 取 沿で きます。 指定す る 親が いない 場合には （鉍丨 •位 附欣 に 
アイテムを 抑 •人す る坳 合）、 hParent には TVLROOT または NULL を 指 泣し ます （効 
は M じ） 〇 K •体 的には 次の ような 感じで アイテムを 抑 •人して いくこと になります 0 

1 • W: 丨 ••位 丨祈 W に アイ, テム 1 を 挿 人す る 

2. 1 •で 取得した ハンドルを hParent に指记 して、 アイテム 2 を揷 入す る 

3 •必要に応じて、 2. を 繰り返す 

または、 次の ような 使い ノア も芩 えられます ， 

1 •ユーザーが ツリー ビューで アイテムを 迸択 し、 そこに 新規に アイテム を记加 する 

2 •選択され ている アイテムの ハンドルを GetSelectedltem メンバ 閲 数で 取得す る 

3 •その ハンドルを liP arem に 指定して 、新規に 沿 加され た アイテムを 仲人す る 

hlnsertAfter には、 表 3-3 にボす 3 神: 類の 侦を 指定で きます 〇 このように アイテムを 神- 
人 できる 位 的は 3 神: 類に 限られ、 任 愆の位 敗に アイテムを 揷人 する ことは できません 



値 


効果 


TVI.FIRST 


兄弟の 中で 先頭に 挿入 


TVI.LAST 


兄弟の 中で 末尾に 挿入 

H 


TVLSORT 


■ 1 ■ ■ ■ 丨 ■ 

アイテムの ラベルで ソー 卜 



表 3-3 挿入 位鼸 



火 際に 揷人 する アイテムの t 丨 報は 敁 後の メンバ 変数、 tv JTEM 惝造 体の 才 ブジェク 卜 
に设 します 〇 TYJTEM 構造体の メンバ 変数は 表 3-4 に /】 ミす ような ものです この 構造 
体には 10 倘の メンバ 変数が あります が、 すべての メンバ 変数に 侦を指 走す る必 •及: はあり ま 
せん。 TVJTEM 惝造 体の mask メンバ 変数に マスク フラグを 指定す ると、 指 沿した フラ 
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グに 対応す る メンバ 変数 だけが 解釈され、 残りの メンバ 変数は 無 祝され るからで す 0 たと 
え ば、 文字列 （ラベル） と 選択 時 Z 非 選択 時の ビットマップ からなる アイテムを 揷 入す るの 
ならば、 

mask = TVIF.TEXT I TVIF.IMAGE I TVIF.SELECTEDIMAGE; 

とする わけです 0 

ところで TV_ITEM 構造体は アイテムの 神 •人 以外に も、 すでに 揷人济 みの アイテムの 侦 
を 取り出す ときに も 使います 。その 閲係丨 ••、挿 人時には 使われない メンバ 変数 も 含まれて 
ぃ ます， 表 3-4 に 他 •人時と 収得 時に 分けて メンバ 変数に 指定す る侦を 解説して おきます 0 



メンバ 変数 


マスク フラグ 


揷入 時の 目的 


取得 時の 目的 


HTREEITEM hltem 


TVIF.HANDLE 


使用せ ず 

- 一 


取得す る アイテムの ハ 
ン ドル 


UINT state 


! TVIF.STATE 


現在の 状態 

— — ■ ■■ 


左に 同じ 

1 ■丨丨 ~ 


UINT stateMask 


TVIF.STATE 


利用す る状聪 


左に 同じ 


LPSTR pszText 


f TVIF.TEXT 


ラベルに K 定 する 文字列 


ラベルを 受け取る バッ 
ファ 


int cchTextMax 


TVIF.TEXT 


使用せ ず 

I 


ラベルを 受け取る バッ 
ファの 長さ 


int ilmage 


TVIF.IMAGE 


菲 iM 択 時の イメージ （イ メー 
丨ジ リストへの インデックス〉 


左に 同じ 


int iSelectedlmage 


! TVIF.SELECTEDIMAGE 


iM 択 時の イメージ （イメージ 
リス 卜への インデックス） 


左に 同じ 


int cChildren 


TVIF.CHILDREN 


コールバックの 指定 


子 ァイテムの 有無 


LPARAM IParam 


TVIF_PARAM 


ユーザーが 定義 


左に 同じ 



表 3-4 TVJTEM 構造体の メンノ 深 数 



♦アイテムを 挿入す る 

TV_INSERTSTKUCTtft 造 体に 侦を設 走したら、 CTreeCtrl::InsertItem メンノ く IW 数を 
使って ツリー ビュー コントロールに アイテムを 揷 人 します。 CTreeCtrblnsertltem メンバ 
閲 数の リ丨 数には、 设定 をした TVJNSERTSTKUCT 構造体への ポインタを 指 泡し ます。 
CTreeCtrl::InsertItem メンバ 関数の 書式は 次のように なって います 0 



HTREEITEM CTreeCtrl::lnsertltem(LPTV.INSERTSTRUCT IpInsertStruct) 



返り 侦 HTREEITEM 揷 入した アイテムを 不す ハンドル 

リ I 数 LPTV INSERTSTRUCTZp/nse パ 挿 人す る アイテム 



ツリー ビュー コン 卜 ロールを 使って みよう 

ツリー ビュー コントロールに アイテムを 挿入す るには、 以上の ように、 構造体に 必要な 
パラメータを 設定し、 CTreeCtrl::InsertItem メンバ 問 数を 呼び出す、 という ステップを 踏 
みます。 

籲 「お 気! こ 入り」 アイテムを 挿入して みる 

それでは URL マネージャで 使 叩して いる コードを もとに H 体 的な アイテムの 揷人 方法を 
解説し ましよう 。まずは ツリー ビュー コントロールに アイテムを 1 つ 挿 人す るた めの メンバ 丨划 
数を CURI / TreeView クラスに 逍 加し ます， この メンバ 問 数では、 TV_INSERTSTRUCT 
構造体の 初期化と、 アイテムの 追加を 行う CTreeCt 士 Insertltem メンバ 関数の 呼び出し 
を 行います。 

いつもの ように、 ワーク スペース ウインドウの [ ClassView ] から、 次のようにして CURL 
TreeViewdnsertltem メンバ 関数を 作成して ください 〇 Insertltem 閲 数の 基 式は 次のと 
おりです。 



HTREEITEM CURLTreeView::lnsertltem(HTREEITEM hParent, LPSTR pszText, 

BOOL bFolder, LPARAM pos) 




図 3-7 CUR じ 〇66\/冶\^::丨阳611丨丨6巾メンバ間数の追加 



さらに、 たった今 作成した CURI / TreeView :: InsertItem メンバ 関数の 中身に、 リスト 
3 - 5 の 内 料を 人力して ください 0 

リス 卜 3-5 CURLTreeView :: lnsert 丨 tem メン ノ观数 （ URLTreeView . cpp ) 

HTREEITEM CURLTreeView: : InsertltemC 
HTREEITEM hParent, // 親 アイテムの ハンドル 
LPSTR pszText, // ラベルに 設定す る 文字列 

BOOL bFolder, // フォルダ ならば TRUE、 URL 情報なら ば FALSE 

LPARAM pos) // ドキュメント クラスに 登録され ている URL 情報への インデックス 

{ 

TV.INSERTSTRUCT treeitem; 

CTreeCtrlft treeCtrl = GetTreeCtrlO ; 
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treeitem.hParent = hParent; 
treeitem.hlnsertAfter = TVI.SORT; 
treeitem. item. mask = TVIF.TEXT I TVIF^IMAGE I 

TVIF.SELECTEDIMAGE I TVIF.PARAM; 
treeitem • item . pszText = pszText; 
treeitem. item. ilmage = bFolder ? 0 : 2; 
treeitem. item. iSelectedlmage = bFolder ? 1 : 3; 
treeitem. item. lParam = bFolder ? -1 : pos; 

HTREEITEM hltem = treeCtrl . Insertltem(&treeitem) ; 



return hltem; 



では、 CUR じ TreeVie\v :: InsertItcm メンバ 丨 数で TVJNSERTSTRUCT 構造体 および 
TV_ITEM 構造体に 設 走して いる 侦 について 解説し ましょう。 先に も 解説した ように 
TV_ITEM 構造体には かならずしも すべての メンバ 変数に 侦を •没记 する 必 •皮はありません。 
ここで 設 走して いる メンバ 変数は 表 3-5 に/ ji す 4 つです。 



メンバ 変数 


指定す る 値 


pszText 


ラベルに 設定す る 文字列 


ilmage 


非 JM 択 時の イメージ （フォルダ ならば 〇、 URL 情報なら ば 1 ) 

■■■■国 


iSelectedlmage 


選 択 時の イメージ （フォルダ ならば 2、 URL 情報なら ば 3) 


IParam 


CURLManDoc::m-arrayURL メンバ 変数への インデックス。 
ッリー ビューに 登録した アイテムに 対応す る 情報を 示す 



表 3-5 URL マネージャで 使う TV JTEM 橘 造 体の メンノ 深 数 



これらの うち lParam メンバ 変数に ついては、 その 使い方は ブロ グラマが 肖 丨丨丨 に 決める 
ことができる ことに なって います。 つま 丨） この メンバ 変数が ツリー ビュー コントロールの 
励 作に 彩郛を 及ぼす ことはありません 。そこで、 URL マネージャでは、 ツ リー ビューに 祭 
鉍 した アイテムに 対応す る、 ドキュメント クラスで 竹邱 されて いる 怡 報を 示す ために 使坩 
しています。 ドキュメント クラスでは CUKLManDoc::m_arrayURL メンバ fld 列 変数に 悄 
報を 格納して いますから、 この M 列への インデックスを ip aram メンバ 変数に 保存して い 
ます。 ただし、 揷 人 する アイテムが フォルダで あれば、 そのこと を 示す ために l Param メ 
ンバ 変数には -1 を 保存して います。 この 侦の 使い方は あとで 解説し ますが、 ツ リー ビュー 
コントロールの アイテムを クリックした ときに、 CBrowserView クラスの ベインに 表示す 
る Web ページの URL を 取得す るた めに 保# しています。 とりあえず、 今のところは 保存 
する だけで 参照され る ことはありません。 
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3 ツリー ビュー コン 卜 ロールを 使って みよう 



ilmage メンバ 変数と iSelectedlmage メンバ 変数には、 CTreeCtrl::SetImageList メン 
バ閲 数で 登録した イメージ リス 卜への インデックスを 指定して います。 先に 發録 した イ メー 
ジリ ストは 

•インデックスが 0 : フォルダの 非 選択 時の イメージ 
•インデックスが 1 : フォルダの 選択 叫の イメージ 
•インデックスが 2 : UKL 悄 報の JI : 選択 時の イメージ 
•インデックスが 3 : URL W 報の 選択 咚の イメージ 

となって いました から （リス 卜 3-2)、 そのよう に侦を 桁^し ます。 

以丨 ••、表 3-5 に， ji した 4 つの メンバ 変数に だけ 侦を 設 定し 、新た: こ 挿 人す る アイテムの 
パラメータ とする ため 、 mask メンバ 変数には 次の 侦 を, 没定 しています 。このように、 利 
用す る メンバ 変数に 対応す る マスク フラグを 淪观 和で 加えた 侦を 指定し ます 〇 

treeitera. item. mask = TVIF.TEXT I TVIF_IMAGE I 

TVIF.SELECTEDIMAGE I TVIF.PARAM; 

TV - INSERTSTRUCT 構造体の オブジェクト （ treeitem ) の メンバ 変数に 侦を 指定し 終 
わっ たら、 CTreeCtrl::InsertItem メンバ 問 数を 呼び出して アイテムを 揷人 します が、 その 
使い方は すでに 解説した とおりです。 

これで ツリー コントロールに アイテムを 揷 人す る 問 数が 完成した ので、 CFriendTrce 
View::OnInitialUpdate メンバ 閲 数に、 「お気に入り」 アイテムを 挿入す る コードを 追加し 
ます （リスト 3-6 >〇 さきほど も 述べた ように、 URL マネージャを 起動す ると、 「お ノ メ U こ 入 
り」 アイテムが ツリー ビュー コントロールに 挿 人され た 状態で ウィンドウが 衣 示されます 
から、 この 作衮は OnlnitialUpdate メンバ 閲 数で 行う のが 適切です 0 



リス 卜 3-6 「お気に入り」 アイテムを 挿入す る⑴ RLTreeView . cpp ) 

void CURLTreeView: :OnInitialUpdate() 

{ 

CTreeCtrlft treeCtrl = GetTreeCtrlO ; 



if (m.pImageList == NULL) { 

CB it map bitmap; 

m—pImageList = new CImageList; 
m-pImageList->Create(16, 16, TRUE, 4, 2); 
for (int i = 0; i < 4; i++) { 
bitmap. LoadBitmap(IDB.FOLDERCLOSE + i) ; 
m.pImageList->Add(&bitmap, RGB(0x80, 0x00, 0x00)); 
bitmap. DeleteObjectO ; 

> 

treeCtrl. Set ImageListCm.pImageList, TVSIL.NORMAL) ; 
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treeCtrl .DeleteAllltemsO ; 

Insertltem( 

NULL, "遇 上位 階層に アイテムを 挿入す る 

_T (" お気に入り ••） ， // ラベルに ‘‘ お気に入り" を 指定 

TRUE, "TRUE は フォルダを 表す 

-1); // フォルダを 挿入す るので 無条件に -1 を 指定 

CTreeView: :OnInitialUpdate() ; 



ここでは、 CURLTreeView::InsertItem メンバ 関数を 呼び 川す 前に、 CTreeCtrl::L)elete 

Allltems メンバ 関数を 呼び出して います。 この メンバ 閲 数を 呼び出す と、 名前のと おり ッ 
リー ビ ュー コン 卜 ロールに 众鉍 されて いる アイテムを すべて 削除して 乍に します。 UKI マ 
ネー ジャ を起勋 した め: 後なら ば、 まだ 何も アイテムは 赍録 されて いないので 無意味で すが、 
データ フ ァイ ルを 開いた ときに もう. 度 「おシ (に 人り」 アイテムを 挿 人して しまったり 、内 
度 データ フ ァイ ルを 開いた ときに、 肋に 及, 八 •していた データが 残って しまう のを 防ぐ ため 
に 呼び 川して います。 

BOOL CTreeCtrl :: DeleteAllltems 〇 

返り 侦 BOOL 成功 すれば TRUE を、 欠 •敗 すれば FALSE を 返す 

リス 卜 3-6 では、 ラベルに 使う 义卞 列に、 中. 純に 「••お に 人り"」 を 指 走す るので はなく、 
• T 関 数を 使っ ています が、 これは ユニコ 一 ドに 対応す るた めの 措阶の 1 つ です Visual 
C++ では# define を 使って _UNICODI£ が记 在され ている と、 いくつかの 閲 数が ユ ニコー 
ド 対応の ものに 的き 変わる しくみが 川 总 されて います。 _丁 閲数も そのうちの 丨 つ であり、 
通常は 何も 処理を 行わずに 引数の 文字列を そのまま 返す だけです が、- UNIC〇DE が 定義 
されて ると リ丨 数の 义卞 列を ュニコ 一 ドに 変換して 返す ようになります プログラム 屮に现 
れる リテラル 文卞 列に _ T 関数を 使って おけば、 わずかな 変更を 加えて コンパイルし 斑す だ 
けで ュニコ 一 ドに 対応した アプリケーションを 作る ことができます 
以丨 ••の 作 袋で U た 丨丨の 変化を 確認で きる だけの コードが そろった ので、 ひとまず ビル ド 
して、 結 米を 確認して おき ましょう。 図 3-8 のよう な丨由 j 丨 f 丨丨が 無* Jf 表示され たでしょう か。 
それでは: fed け C 、 祝み 込ん た データファイルを もとに、 ツリー ビュー コントロールへ アイ 
テムを 挿入す る 部分の 解説を 行います。 
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図 3-8 ここまでの 作業 結果。 まだ データファイルを K み 込んでも 表示され ない 



參 データファイルを もとに アイテムを 挿入す る 

「お ノ メ U こ 人り」 アイテムの 神人に 絞いて、 説み 込んだ データファイルを もとに、 アイテム 
を揷 人す る コードを 追加し ます。 

この 作業は CView :: OnUpate 仮想 メンバ 関数を オーバーライドして 行います 。この 侃 
想 メンバ 問 数は、 CDocument::UpdateA 丨丨 Views メンバ WI 数を 呼び 川 したと きか、 ビュー 
が 初期化 された ときに 呼び出されます 0 •般 的には、 ドキュメントが 新され たと きに 
迚勋 して ビューを Oi 新す るた めに 使われる 仮想 メンバ 間数です。 たとえば、 ファイルを 
オーブン すると、 CDocument クラスから CView::OnInitialUpdate 仮想 メンバ 関 数が 呼び 
川 され、 そこから さらに CView :: OnUpdate 仮想 メンバ 閲 数が 呼び出されます 〇 ただし、 
CView :: OnInitialUpdate 仮想 メンバ 閲 数を オーバ一ライドして しまう と、 当然 CViewWn 
Update 仮想 メンバ 関数を 呼び出す コードは 丨 ••畨 きされ、 呼び 川 され なくなって しまい ま 
す 。そこで、 CView::OnInitialUpdate 仮想 メンバ 閲 数を オーバーライド するとき には、 明 
示 的に CView::OnInitialUpdate 仮想 メンバ 閲 数を 呼び出す コードを 含めて おかなければ な 
りません 。この コードは すでに リス 卜 3-6 に禽 まれて いるので 、「お 父に 人り」 アイテムが 
揷 人され た 麻 後に CUKl/TreeView :: OnUpdate メンバ 閲 数が 呼び出されます 0 
CView::OnUpdate メンバ 関数は 次のように 定 在され ています 0 

void CView::OnUpdate(CView* pSender, LPARAM IHint, CObject* pHint) 

引数 CView* pSendw OnUpdate 仮想 メンバ 問 数を 呼び出す きっかけ となった ビ 

ュ 一才 ブジェク ト 。きっかけが ドキュメント オブジェクト 
など ビュー 才 ブジェク 卜 以外の 場合は NULL となり、 すべ 
ての ビューの！ li 新を 意味す る 
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LPARAM IHint )丨1 途は 定められて いない。 ビューの! ii 新に 必要な 情報の 受 

け 渡しに 使う 

CObject* pHint ⑴途は 定められて いない。 ビューの 史 新に 必要な 悄報 の受 

け 渡しに 使う 

それでは、 表 3-6 を 参考に して、 CURI / TreeView クラスで CView :: 0 丨 ilipdatc 仮想 メ 
ンバ 関数を 才ー バーラ イドして ください 。この 作衮 には ClassWizard 、 または WizardBar 
を 利〗 | j できます。 



クラス 


オブジェクト ID 


メッセージ 


CURLTreeView 


なし （ CURl_TreeView を iM 択） 


OnUpdate 



表 3-6 OnUpdate 関数の オーバーライド 



続いて、 リスト 3-7 の 内 料を 今 作成した CURI / TreeView こ OnUpdate 仮想 メンバ 関数に 
i £ i 加して ください。 

リス 卜 3-7 CURLTreeView::OnUpdate 仮想 メンバ 閫数 （ URLTreeView.cpp) 



void CURLTreeView: :OnUpdate(CView* pSender, LPARAM IHint, CObject* pHint) 

{ 

if (pSender == NULL) { 

/* initialize tree */ 

CURLManDoc* pDoc = GetDocument () ; 

CTreeCtrlft treectrl = GetTreeCtrl () ; 

HTREEITEM hTopItem = treectrl .GetFirstVisibleltemO ; 

// 先頭 アイテムの 位* を 取得す る 
HTREEITEM hCurrentltem = hTopItem; 

// アイテムを 挿入す る 位 * (親 アイテムの 位 S {を hTopItem で 初期化す る 
CURLEntry* pURL = NULL; 

for Kmt i = 0; i < pDoc->m_nIndex; i++) i 
pURL = pDoc->m_arrayURL[i] ; 
if (pURL->getURL 〇 == "dir") { 

"フォルダの 作成 

" フォルダが 作成され るのは、 常に r お気に入り」 の 下 
hCurrentltem = Insertltem( 

hTopItem, "挿入す る アイテムの 親 アイテム 

pURL->getTitle() .GetBuf f er(pURL->getTitle() .GetLengthO ) , 

// アイテムの ラベルに 設定す る 文字列 
TRUE, //TRUE ならば フォルダの ビットマップ 

-1); // フォルダの ときは - 1 

//URL 情報 アイテムを 挿入す る 位* を 表す hCurrentltem に 
// 今 作った フォルダの 位 » を 保存す る 









342 



3 ツリー ビュー コン 卜 □一 ルを 使って みよう 



} else if (pURL->getURL() == "up") { 

/ ✓フォルダの 終了 

hCurrentltem = hTopItem; 

// アイテムが 作成され る 親 アイテムを hTopItem に 戻す 
} else { 

Insertltem( 

hCurrentltem, // 挿入す る アイテムの 親 アイテム 

pURL->getTitle() .GetBuf f er (pURL->getTitle() .GetLengthO ) , 

"アイテムの ラベルに 設定す る 文字列 
FALSE, // FALSE ならば URL « 報の ビットマップ 

i ) ; " URL 情報の 時は CURLManDoc :: m _ arrayURL への イン テックス 




ここでの おおまかな 作 彩は、 データファイルから 説み 込んだ デ 一夕が 格納され ている 
(：し’1?し\13丨1〇0(：::111_3び3ン111?しメンバ|11!列変数を陬にアクセスして、フ才ルダか〇1 ; {し惝報 
かを 判断しながら、 適切な アイテムを 挿 人して いくとい う ものです， 

それでは 姒 初から 順に 兄て いきましょう。 先頒 部分では まずい つもの ように CTreeC 
trhGetTreeCtrl メンバ 問 数を 呼び 川 して、 CTreeCtr 丨沏才 ブジェク 卜を 取得して います 0 

この 才 ブジェク 卜がなければ ツリー ビュー コントロールを 找作 できない のはす でに 述べた 
とおりです。 

次に、 CTreeCt 丨 - hGetFirstVisiblelteni メンバ 閲 数を 呼び 川 
光 Stf (の アイテムに 対応す る ハンドルを 取得して います 〇 CURI / TreeView :: OnUpdate 仮想 
メンバ 問 数が 呼び 川され ると きには、 CURI / TreeView :: OnInitialUpdate 奴 想 メンバ 閲 数 

で 挿 人した 「おン (に 人り」 アイテム だけが む:/ 丨 •: している ので、 この アイテムが 取り 川され 
ます 。そして、 この ハンドルを hTopItem 変数に 保存して おきます 。この 変数は ル一 トア 
イ テムを 衣し、 フ ォルダを 作成す る 位吖 を尔 すため に 使われます。 また、 hTopItem 変数 

を hCurrentltem 変数に コピーして いますが、 hCurrentltem 変数は URL 悄 報を 格納す る 

フ ォルダを ボ すため に 使われます。 

その あとの ループでは、 CURL \ IanL ) oc ::: m_arrayUKL メンバ fli ! 列 変数の 要 ぶに 1 つ 1 つ 
アクセスし、 CURLEntry :: m _ strURL に 格納され ている 文字列が- dir ” ならば フォルダ ア 
イ テムを 神人し ます 0 こ のとき、 新たに 作成した フォルダ アイテムの 位 的を ボす ハンドル 

( CURLTreeView::InsertItem メンバ 変数の 返り 船を hCurrentltem 変数に 代入し、 これ 

以後 作成され る URL W 報が この フォルダの ドに 作成され るよう にして い 字す 




また“ 叩” ならば、 hCurrentltem 変数へ hTopItem 変数の 侦を 代人して、 これ 以後 作 
成される URL 情報が 挿 人され る 位!? {を hTopItem 変数に 格納され ている 位 （（「お 铽に入 
り」 アイテムの 下） に 戻します。 

それ 以外なら ば、 URL 情報と して アイテムを 揷人 しています。 

この あたりの 仕様に ついては CURLManDoc クラスの 实装で 述べた とおりです。 

さて、 これで やっと データファイルを 読み込んで、 ツリー ビュー コントロールに 表示で 
きる ようになりました。 さっそく ビル ドして、 实 行して みましょう。 もう 忘れて しまった 
かもしれ ません が、 URL マネージャで 読み込む データファイルを 作成す るには、 l sur l ツー 
ルを 使います。 

ただし、 lsurl ツールを 使用す るには、 Developer Studio から URLMan¥lsURL フォル 
ダに ある lslIKL プロジェクトを 開いて、 ブロ グラムを ビル ドす る 必要が あります。 

ビル ドした lsurl.exe は DOS ブロン ブトから 次のようにして 灾 行して ください。 

lsurl く 出力 ファイル 名〉 

例： 

lsurl favorites. 1st 

こうして 作成した ファイルを URL マネージャで 開けば、 図 3-9 のように 衣ポ されます 0 
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3.5 フォルダの 状態！ こよって ビットマップを 切り替える 

URL マネージャ も 残す ところ CBrowserView クラスの 実装の み、 といきたい ところで 
すが、 その 前に 1 っ だけ 気になる 点が あるので、 先に 処理して しまい ましよう。 それは、 
フォルダの ビットマップです 0 いじって みた 方は わかる と 思います が、 フォルダ も URL 悄 
報 も 同じように、 アイテムを クリックして 選択され たと きに ビットマップが 切り# わり ま 
す 〇 URL 悄 報は それでも かまわな いのです が、 フォルダの 方は やはり エクスプローラと 向 
じように、 下の 附 W が 衣/ ji されて いると きに ビットマップを 切り 锊 えたいと ころです 。そ 
こで、 この 処现を 追加す る ことにし ましよう。 

この 処理を 灾現 する ためには、 CURLTreeView こ Insertltem メンバ 関数を リス 卜 3-8 の 
ように 2 行変史 します。 



リス 卜 3-8 変更され た CUR じ TreeView::lnsertltem メンバ 間数 



HTREEITEM CURLTreeView: : Insert Item (HTREEITEM hParent, LPSTR pszText, 

BOOL bDirectory, LPARAM pos) 

{ 

TV.INSERTSTRUCT treeitem; 

CTreeCtrlfe treeCtrl = GetTreeCtrlO ; 



treeitem.hParent = hPaorent; 
treeitem.hlnsert After = TVI.SORT; 
treeitem. item. mask = TVIF.TEXT I TVIF.IMAGE I 

TVIF.SELECTEDIMAGE I TVIF.PARAM; 
treeitem. item. pszText = pszText; 



✓/ 次の 2 行を 害き 換える 

treeitem. item- ilmage = bFolder ? I.IMAGECALLBACK : 2; 
treeitem- item •iSelectedlmage = bFolder ? I.IMAGECALLBACK : 3; 

treeitem. item. lFaram = bFolder ? -1 : pos; 

HTREEITEM hltem = treeCtrl . InsertltemC&treeitem) ; 




return hltem; 



揷 人され る アイテムが フォルダ のとき だけ、 TVJTEM::iImage メンバ 変数と TV_ITEM:: 
iSelectedlmage メンバ 変数に イメージ リストへの インデックスの 代わりに、 IJMAGEC ALL 
BACK という 特殊な 侦を 代入して います。 この 侦を 代入して おくと、 固定 的に イメージ リ 
スト 上の ビットマップを 指定す る ことは なくなり、 アイテムが 表示され ると きになる と （ア 
イ テムが 挿入され たり、 クリック された ときな ど）、 TVN_GETDISPINFO 通知 メッセ一 
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ジが ツリー ビュー コントロールに 送信され るよう になります。 そして、 この メッセージ ハ 
ン ドラで 指定した イメージ リストへの インデックスが 使われる ようにな ります。 したが つ 
て、 メッセージ ハンドラで フ ォルダが 展開され ている かを 調べて、 適切な インデックスを 
返せば、 所望の 機能が 実現で きる という わけです。 

それでは、 TVN-GETDISPINFO 通知メッセージ ハンドラを 作成し ましょう 。これには 
Class Wizard か WizardBar を 使います 。すると、 CURI/TreeView::OnGetdispinfo メンバ 
関数が 作成され ます。 



クラス 


オブジェクト ID 


メッセージ 


メッセージ ハンドラ 


CURLTreeView 


なし （ CURLTreeView を 指定） 


TVN.GETDISPINFO 


OnGetdispinfo 



表 3-7 TVN_GETDISPINFO メッセージ ハンドラ 



続けて、 リス 卜 3-9 に 小す ように、 CURLTreeVievv::OnGetdispinfo メンバ 閲 数の 中身 
を 人力して ください。 

リス 卜 3-9 CURLTreeView :: OnGetdispinfo メッセージ ハンドラ ⑴ RLTreeView . cpp ) 

void CURLTreeView: :OnGetdispinfo(NMHDR* pNMHDR, LRESULT* pResult) 

TV.DISPINFO* pTVDispInfo = (TV.DISPINFO*)pNMHDR; 

HTREEITEM hltem = pTVDispInfo->item.hItem; 

CTreeCtrlft treectrl = GetTreeCtrlO ; 

if (pTVDispInfo->item.mask & TVIF_IMAGE II 

pTVDispInfo->item.mask & TVIF.SELECTEDIMAGE) { 
if (pTVDispInfo->item. state k TVIS.EXPANDED) { 
pTVDispInfo->item. ilmage = 

pTVDispInfo->item. iSelectedlmage = 1; 

} else { 

pTVDispInfo->item. ilmage = 

pTVDispInfo->item. iSelectedlmage = 0; 



♦pResult = 0; 



ここで 行つ ている 処理は、 アイテムが 展開され ている かどう かを 調べ、 展開され ていれ 
ば イメージ リストへの インデックス として 1( 開いて いる フォルダの ビットマップ） を 返し、 
そうでなければ 0( 閉じて いる フォルダの ビットマップ） を 返す という ものです。 
CURLTreeView::OnGetdispinfo メンバ 閲 数は 次のように 定義され ています。 
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void CURLTreeView::OnGetdispinfo(NMHDR* pNMHDR , LRESULT* pResult ) 

引数 NMHDR* piVMHZ)/? TVN_GETDISPINFO メッセージの 引き金と なった アイ 

テムの 情報が 格納され る 

LRESULT* IResult 返り 侦を IResult へ 格納す る 

リ丨 数で 渡される pNMHDK 変数は iti 初 NMHDR 構造体への ポインタ として 渡されます 
が、 実際には TV こ DISPINFO 構造体への ポ イン 夕な ので、 キャス 卜してから 利用し ます 0 
TV_I)ISPINFO 惝造 体は 次のように 定義され ています。 必要な W •報は すべて TV JTEM 
彻 item メンバ 変数の 屮に 格納され ています 〇 TVJTEM 偁造 体に ついては すでに 解説 済 
みなので 繰り返しは 避けます が、 すべての メンバ 変数に アクセス できる わけでは ない ので、 
その 办 について 解説し ます。 TVN_GETI)ISPINFO メッセージ ハンドラで 読み出せる メン 
バ 変数は、 mask、 hltem、 state、 IParam の 4 つ だけです。 それ 以外の メンバ 変数には 無 
意味な 侦が 格納され ている だけです 。これら 無意味な 侦が 格納され ている メンバ 変数は、 倘 
を 返す ために 使われます 。ここでは ビットマップを 切り 持え るの が II 的です から、 ilmage 
メンバ 変数と iSelectedlmage メンバ 変数へ 侦を 格納して、 メッセージ ハンドラを 終 广 し 
ます。 



リス 卜 3-10 TV_DISPINFO 構造体 



struct TV.DISPINFO 



NMHDR hdr; 

TV.ITEM item; 

/* 

UINT mask; メッセージ ハンドラで 返すべき 値が 指示され ている 

HTREEITEM hltem; メッセージ ハンドラで 情報を 投定 する アイテム 
UINT state; hltem に 対応す る アイテムの 状賅 

UINT stateMask; 

LPSTR pszText ; 
int cchTextMax; 




l Image; 

lSelectedlmage; 

cChildren; 

IParam; 用途は 自由 



>; 



メッセージ ハンドラの 中身を U てみ ましよう 。まず 敁 初の if 文では、 TV_DISPINFa:item. 
mask メンバ 変数を 参照して います 〇 TV_DISPINFO 構造体、 および item.mask が 取りう 
る侦 について は リス 卜 3-10 および 表 3-8 を 参照して ください 〇 item.mask メンバ 変数に 
は、 メッセージ ハンドラで 返すべき メンバ 変数は どれ かを 指示す る侦が 格納され ています 0 
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ここでは、 TVIFJMAGE か TVIF _ SELECTEDIMAGE だった とき だけ、 処理を 行って 
ぃます〇なぉ、1^«^丁£乂丁ゃ1^«^011し01^^を使ぅには、〇丁收0土1脱バ^111 
メンバ 閱 数で アイテムを 挿 人 するとき に、 UMAGECALLBACK と 似た 特殊な 侦を 使う 
必欢 があります。 ただし、 ここでは これ 以 I •.触れません。 



mask の 値 


目的 


TVIF.TEXT 


ラベル （ pszText ) を 設定す る 


TVIFJMAGE 


非 選 択 時の ビットマップ ( ilmage ) を 設定す る 


TVIF.SELECTEDIMAGE 


S 択 時の ビットマップ (巴6丨6(：丨6づ丨^1396)を設定する 


TVIF-CHILDREN 


子 アイテムの 数 ( cChildren ) を 設定す る 


表 3-8 mask メンノ 深 数が 取りうる 値 



次に、 TV - DISPINFOdtem.state メンバ 変数を 参照して、 アイテムが 展開され ている か 
どうかを 判断して います 。この 変数の 傲は、 表 3-9 に 示す 侦の論 fl ! •和で 構成され ている ため、 
中 •純に 等け で 比較す る だけでは なく、 論 现秘を 使って 丨丨 的の 侦 だけを 取り/ II す必 •出が あり 
ます 。ここでは アイテムが 展 間され ている かどう かを •利べ たいので、 TVISJiXPANDKI ) 
が 欠 まれて いるかを 調べて います 0 そして、 展開され ていれば、 il mage メンバ 変数と 

iSe 丨 ectedlmage メンバ 変数に 1 を、 そうでなければ 〇 を 代人して います 〇 URL マネージャ 

では 選択され ている か” かを 無 祝して、 展開され ている かどう か だけで ビットマップを 切 
り枰 える ため 、 ilmage メンバ 変数と iSelectedlmage メンバ 変数には 丨 iij じ侦を セットして 
います。 



state の 値 
TVIS.BOLD 
TVIS.CUT 
TVIS 一 DROPHILITED 
TVIS.EXPANDED 
TVIS_EXPANDEDONCE 
TVIS.EXPANDPARTIAL 
TVI .9 <^FI FP.TPn 



意味 

アイテムが ボールド 表示され ている 
カツ 卜 & ペース 卜 処理の ために 選択され ている 
ドラ ツグ & ドロ 2 プの ターゲット として 選択され ている 
アイテムが 展開され、 子 アイテムが 表示され ている 
子 アイテムが 一度は 展開され ている 

I 1 - " ■ 

子 アイテムの 一部が 展開され ている 

*77 ノ；/ ム ぐ、 W 4 D ★ h ブ •、ブ 




以 I ••で ビット マッ プの 切り 枰 えに 問す る コードの 沿 加は 終 r です。 ビル ドして 励 作を 確 
，忍して みて くた さい 0 フ オルダを 選択しても ビットマップは 切り 荇 わらず、 展開した とき 
だけ 切り 枰 われば 成功です。 
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下の％ 層が R 示？ れ ている 
フォルダの ヒ ノト マン ブ U 
W いた ものに なって いる — 
濃択 されて いる URL の 一 
ヒノ トマ ノブ 11 左下が 
光って いる 







ASCBCOVCftATT 



•; 力 



UT4 



TTI 



図 3-10 展開して いるか 否かで ビッ卜 マップが 切り替わる ようにな つた 



3.6 アイテムを クリックして Web ページを 表示す る 

さあ、 いよいよ 人 詰めです。 Iti 後に 残された 処 那 は、 ツリー ビュー コントロールの URL 
W 报 アイテムが クリック された ときに、 HTML コントロールに Web ページを 衣 示す る コー 
ドを 沿 加し ましょう 。この 作 茨は、 次の ステップに 分かれて います 0 

1. ツリー ビュー コントロールの アイテムが クリック された ことを 検 丨丨丨 する 

2. ドキュメント オブジェクトから、 クリック された アイテムに 対応す る URL を 取り 
出す 

3. HTML ビュー コントロールで、 指定した URL を 衣 示す る 

•アイテムが クリック された ことを 検出す る 

Windows プログラミングでは、 ウインドウ に対する ユーザーの 操作は すべて メッセージ 
という 形で アプリケーションに M 知され ますが、 ツリー ビュー コントロール でも これは 例 
外ではありません 。ツリー ビュー コントロールに) IL 6； されて いる 12 神: 類の 通知メッセージ 
のなかから TVN _ SELCHANGEr ) 通知メッセージを ノ 、ン ドル すれば、 アイテムが ク リッ 
ク されて 選択され た 瞬 問を 捕らえる ことができます 〇 TVN-SELCH ANGED 通知 メッセ 一 
ジは 、選択され ている アイテムが 変史 された ときに 発行され る メッセージです 0 
それでは 表 3-10 に從っ て、 ClassWizard を 使って TVIsLSELCHANGED メッセージの 
ハンドラを 作成して ください 0 

TVN_SELCHANGED メッセージに 対応す る ノヽン ドラの 杳式は 次のように 定義され てい 
ます。 




3.6 アイテムを クリックして Web ページを 表示す る 



クラス 


オブジェクト ID 


メッセージ 


CURLTreeView 


なし （ CURLTreeView クラスを 選択） 


TVN_SELCHANGED 



表 3-10 TVN-SELCHANGED メッセージの ハンドラの 指定 



void CURLTreeView::OnSelchanged(NMHDR* pNMHDR. LRESULT* pResult) 



リ丨数 NMHDR * pNMHDR アイテムを 選択した ときの 怡報 
LRESULT* pResult メッセージ ハンドラの 結！ ft を 返す 

pNMIIDR は NMIIDR 惝造 体への ポインタ として i 度され ますが、 火 際には NM_TREE 
VIEW _造 休への ポインタ となって いるので 、キャストして 利丨 丨丨 します。 nm_treeview 
構造体は 次の ような メンバ 変数を 持って います。 

typedef struct _NM_TREEVIEW { 

NMHDR hdr; 

UINT action; // TVC.BYKEYBOARD or TVC.BYMOUSE or TVC.UNKNOWN 
TV.ITEM itemOld; // 直前に 1M 択 されて いた アイテム 

(hltem. state. IParam 以外の 値は 不定） 

TV.ITEM itemNew; // 新しく 択 された アイテム （同上） 

POINT ptDrag; 

} NM.TREEVIEW; 

通知メッセージの メッセージ ハンドラには 返り 付 (がありません が、 代わりに* p R esu 丨 t に 
結 米を 代人して メッセージ ハンドラを 終 r する ことに なって います 。代人すべき 侦は マニ ユ 
アルから 通知メッセージを 検索し （ここでは TVN _ SELCHANGED)、 [Return Value ] の 
功1丨 に指ポ されて いる 侦を 代人し ます 〇 TVN - SELCHANGED 通知メッセージの 場合には 
「返り 侦はイ ぐ 要」 とあります から、 〇 でも 代人して おけば よいでしょう。 

URL マネージ ャ では リス 卜 3-11 のように TVN-SELCHANGED メッセージ ハンドラ 
を灾 装して います。 

リス 卜 3-1 1 TVN-SELCHANGED メッセ一 ジの ハンドラ ⑴ RLTreeView.cpp) 
void CURLTreeView: :0nSelchanged (NMHDR* pNMHDR, LRESULT* pResult) 

NM.TREEVIEW* pNMTreeView = (NM.TREEVIEW*)pNMHDR; 

CURLMcinDoc* pDoc = GetDocument () ; 



CTreeCtrl& treectrl = GetTreeCtrlO ; 



TV_ITEM treeitem; 

treeitem. hltem = pNMTreeView->itemNew. hltem; 






350 



3 ツリー ビュー コン 卜 □一 ルを 使って みよう 



treeitem.mask = TVIF.PARAM; 
treectrl . Get Itera(&treeitem) ; 

if (treeitem. lParam != -1) { 

// クリックした アイテムが URL 情報の 場合 

pDoc->UpdateAHViews(this, treeitem. lParam, NULL); 
//CBrowserView::OnUpdate メンバ 関数の 呼び出しに つながる 



*pResult = 0; 



ここでの 処现の 中心は、 CTreeCtrl::GetItem メンバ 問 数の 呼び 山し と、 CDocument::Up 
dateAUViews メンバ 関数の 呼び 川し にあります 0 

まず CTreeCt 土 Getltem メンバ 関数の 呼び 川 しです が、 これは 进択 された アイテムに 保 
存 されて いる TV_ITEMdParam メンバ 変数の 侦を 取り出す ための 処 那で す。 アイテムを 
神人 するとき、 アイテムが URLt/f 報なら ば TV_ITEM::IParam メンバ 変数に ドキ ュメン 
ト才 ブジェク 卜への インデックスを 、フォルダ ならば- 1 を 保む: して おいた ことを 觉 えてい 
るで しよう か。 この W (を 取り出せば、 アイテムに 対 Lt する UKL を ドキュメント 才 ブジェク 
卜から 取得で きます。 そこで、 CTreeCtrl::GetItem メンバ 閲数 によって lParam を 取り 川 
し、 次の CDocument::UpdateAllViews メンバ 閲 数の 呼び /M しで、 CBrowserView クラス 
へと lParam の侦を 渡して いる わけです。 

CTreeCt 士 Getltem メンバ 間数は 次のように 定義され ています 0 

BOOL CTreeCtrl::Getltem(TV_ITEM* pltem); 

返り 倘 BOOL I 丨:常 終 广 した 坳介は TRUE、 與常 終了した 場 介は FALSE 

を 返す 

リ丨数 TVJTEM*p//em 怕钳 を 取 W したい アイテムと 怙報饨 を 指定す る 。また 取得 

した W 報が 格納され る。 

CTreeCtrl::GetItem メンバ 問 数の 使い；; •は、 アイテムの 挿入に 使った CTreeCtrl::Insert 
Item メンバ 問 数と よく 似て います。 TV JTEM 構造体を 使う ところは M じです し、 侦を 
設 走した メンバ 変数を， ji すため に マスク フラグを 使う ところ も丨 "j じです。 TVJTKM 構造 
体 や マスク フラグに っいては 表 3-5 を 参照して ください。 ここでは、 収得したい 怊钳 は 
lParam メンバ 変数 だけな ので、 TV_ITEM::mask メンバ 変数に TVIF_PARAM だけを 代 
入して います 。また、 TV JTEMnhltem メンバ 変数は 取得す る アイテムを 示す ために 使わ 
れ るので、 マスク フラグに かかわらず 必ず 指定す る必贤 があります 。ここでは、 前述した 
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N . VLTREEVIEW 構造体の メンバ 変数から、 新しく 選択され た アイテムの ハンドルを 代人 
しています。 

以上の 準備を してから CTreeCtrhGetltem メンバ 関数を 呼び出す と、 引数と して 渡 
した TV _ ITEM 構造体の メンバ 変数が 卉き 換えられ 、情報を 取得で きます 。ここでは、 
treeitemJParam メンバ 変数に、 指定した アイテムが 持つ IParam の 値が 格納され てきます 0 
こうして 取得した IParam の M を Web ページを 衣/ する ために、 CBrowserView クラ 
ス へと 渡す 作 菜を 行って いるの が CDocument::UpdateAllViews メンバ 関数です。 この メ 
ンバ 関数は すでに 解説した CView コ OnUpdate 仮想 メンバ 関数と 組になって いる 関数で あ 
り、 CDocument::UpdateAllViews メンバ IKJ 数を 呼び 川す と、 ドキュメント オブジェクト 
に 対応して いるすべ ての ビューの CView :: OnUpdate 仮想 メンバ 閲 数が 呼び 川され ます。 

籲 Web ページを 表示す る 

そこで、 ここまで 沈黙を 保って きた CBrowser View クラスへ とつい に: p を 人れ る こと 

にします 〇 表 3-11 に 従い、 ClassWizard を 使って、 CView コ OnUpdate 仮想 メンバ 問 数を 
才ー バーラ イドして、 CBrowserView :: OnUpdate 攸想 メンバ 閲 数を 作成して ください。 こ 
こで IParam の 値を 受け取り、 Web ページを 表示す る 処理を 行います。 



クラス 


オブジェクト ID 


メッセージ 


CBrowserView 


なし （ CBrowserView を 選択） 


OnUpdate 



表 3-1 1 CBrowserView::OnUpdate 仮想 メンバ M 数 



ここでの 処那 •は、 光の CI ) ocument :: UpdateA 丨丨 Views メンバ 閲 数の リ丨 数に 指 走した 丨 Param 
の侦を 受け取り、 Web ページを 衣ボ するとい う、 ごく 簡中 •な ものです。 リス 卜 3-12 の 内 
料を CBrowserView :: OnUpdate 仮想 メンバ 閲 数の 中に 入力して ください 0 

リス 卜 3-12 CBrowserView::OnUpdate 仮想 メンバ 関数 （ BrowserView.cpp) 
void CBrowserView: :OnUpdate(CView* pSender, LPARAM lHint, CObject* pHint) 
if (pSender != NULL) { 

CURLMcinDoc* pDoc = (CURLManDoc*)GetDocument () ; 



Navigat e2 (pDoc->m^arrayURL [lHint] ->getURL ( ) ) ; 




また、 BrowserView . cpp ファイルの 先 iff (部分に、 次の 1 行を 加えて、 CURLManDoc ク 

ラスに アクセス できる ようにして ください。 




3 ツリー ビュー コン 卜 ロールを 使って みよう 



リス 卜 3-13 CURLManDoc クラスに アクセス できる ようにす る （ BrowserView.cpp) 



#include "URLManDoc .h" 



先に CDocument::UpdateAUViews メンバ 関数と CView :: OnUpdate メンバ 関数は 組に 
なって いると 述べました が、 これには 2 つの 味が あります 〇 1 つは、 CDocument::Update 
AllViews メンバ 数を 呼び出す と、 フレームワークから CView::OnUpdate メンバ 閲 数が 
呼び出される 点。 もう 1 つは、 CDocument::UpdateAUViews メンバ 関数の 引数に 指定した 
侦が 、そのまま CView::OnUpdate メンバ 関数の 呼び 川 しに 使われる 点です。 したがって、 
CBrowserView :: OnUpdate 仮想 メンバ 閲 数の リ丨数 lHint には、 ツリー ビュー コントロール 
で 選択した アイテムの 丨 Param の侦 （しつこい ようです が、 CURLManDoc :: m_arraylIRL メ 
ンバ 配列 変数への インデックスです） が 渡されます （ CURLTreeView::OnSelchanged メン 
バ 閲 数の CDocument::UpdateAUViews メンバ 関数を 呼び出し ている 简 所を 参照の こと ）〇 
この 侦 さえ 手に入れば、 あとの 処理は 中 •純です 〇 CURLManDoc :: m _ arrayURL [ lHintl を 
参照して 、 CUKLEntryxgetUKL メンバ 155] 数を 呼び出し、 ツリー ビュー コン 卜 ロールで 逝 
択 した アイテムの URL を 人 T •します 。そして、 CHtmlView に Navigate 2 メンバ 間数を 呼び 
出して、 Html ビュー コントロールに Web ページを 衣 W します。 

void CHtmlView::Navigate2(LPCTSTR IpszURL) 

引数 LPCTSTRZp 從 ひ/? L 衣 示す る Web ページの URL を 指定す る 

般 後に、 CBrowserView コ OnlnitialUpdate 仮想 メンバ 閲 数を 作成して、 URL マネージャ 
が 起動した if 〔後には、 心 •側の ペインに ブランク ページが 衣ポ される ようにして おき ましよ 
う 〇 ClassWizard を 使って、 表 3-12 のように CBrowserView::OnInitialUpdate 仮想 メン 
バ間 数を 作成して ください。 



クラス 1 


オブジェクト ID 


メッセージ 


CBrowserView 


なし （ CBrowserView を 選択） 


OnlnitialUpdate 



表 3-12 OnlnitialUpdate 関数の オーバーライド 



すると、 ClassWizard は 初期 状態で Microsoft の WWW サイトを 開く ための コードを 
追加し ます 。 Visual C ++ プログラマには 有益な 情報が 満載され た WWW サイトで はあり 
ます か' URL マネージャには イ く適冯 ですから、 リス 卜 3-14 のように 変 ill してし まって く 
ださい 。これで、 起動ぬ: 後には ブランク ページが 炎ボ される ようにな ります。 
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リス 卜 3-14 CBrowserView::OnlnitialUpdate 仮想 メンバ 関数 

void CBrowserView: :OnInitialUpdate() 

{ 

Navigator2(.T( ll about:blank li ), NULL, NULL); 



さあ！ これで URL マネージャは ほぼ 完成です。 ビル ドして 動作を 確認して みましょう。 
ツリー ビュー コントロールで アイテムを クリック すると、 Web ページが 衣/ される ハズで 
すが、 どうでしょう か。 




TV 

n 



WELCOME TO 



図 3-11 URL マネージャ、 一応 完成の 図 



4 もう 少し wvvvv ブラウザ らしく 



丨 までで j 丨 i 低 限 ブラウズ できるだけの 作衮を 終えました が、 これで WWW ブラウザを 
名乘 るのは 心; ••，••しい ものが あります から、 もう 少し 丨 辺の 環境を 格え る ことにし ましょう 0 
ここでは 2 つの 機能を CBrowserView クラスに ill 加し ます 〇 1 つは 现 心; 衣尔 している 
Web ページの URL を キャプションに 衣ボ する 機能です 〇 Windows アプリケーションでは、 
现ず丨 : 褊姒屮 の ドキュメント 名な どを アプリケーション 名と ルに キャプションに 衣ボ する のが 
•般 的な 作法と されて いますから、 ぜひ 灾现 して おき ましょう。 もう 1 つは、 [光に 進む] や 
[ lW に W る] などの ナビ ゲー シ ヨン 機能です 。これは わざわざ 作らな くと も、 CBrowserView 
クラスが 竹 坪して いる ウインドウでは、 イ丨 •クリック すると 衣ボ される コンテキスト メニュー 
から 找作 できます が、 キーボードから 槐作 できません し、 [ f ? lU はこの コンテ キス トメ 
ニューには ありません 。そこで、 メニューから これらの 操作を できる ようにして おきます 0 



4.1 キャプションに URL を 表示す る 



キャプションに 现权 衣尔 されて いる URL を 衣 示す るた めには、 

1. 表示が 完了した ことを 検出し 

2. 衣 示されて いる URL を 調べて 

3. キャプションへ 適切な 文字列を 設定す る 

という 3 ステップが 必要になります。 それでは、 骱畨に E ていく ことにし ましよう。 

まずは Web ページの 衣 示完 广 を 検出す る： P •段です が、 この II 的の ために ClltmlView ク 
ラスには、 CHtmlView :: 〇 nNavigateComplete 2 仮想 メンバ 間数が されて います 。この 
仮想 メンバ 問 数は 標準では 何も 処理を 行いません が、 Web ページの 表ボ が完 广 すると、 フ 
レーム ワークから 呼び { li されます。 つまり、 MFC で定 在され ている、 ただ 才ー バーラ イド 
される のを 待って いる だけの 仮想 メンバ 関数の 1 つと いう わけです。 



4 もう 少し WWW ブラウザ らしく 



CHtmlView クラスには こうした 状態の 変化を 捕らえる ための 仮想 メンバ 間数が いくつ 
も 用意され ています。 ここでは 利用し ません が、 表 4-1 に 簡単に 紹介して おきます。 



仮想 メンバ 関数 


目的 


OnBeforeNavigate 2 


ナビ ゲー ション 開始 前に 呼び出される 


OnStatusT extChange 


ステータス バーの テキス 卜が 変更され たこと を 通知す るた めに 呼び出 
される 


OnProgressChange 


ダウンロード 揉 作の 進行状況が 変更され たこと を 通知す るた めに 呼び 
出される。 進行状況を 表す プログレス バーを 実装す るた めに 利用す る 


OnCommandStateChange 


[次に 進む]、 [前に 戻る] などの コマンドの 有効 状態が 変化した ことを 
通知す るた めに 呼び出される 


OnDownloadBegin 


ダウンロード 開始 前に 呼び出される。 ただし 短時間で ダウンロードが 
終了した 塌 合には 呼び出されない 


OnDownloadComplete 


ダウンロードの 成功/失敗に かかわらず、 ナビ ゲー シ ヨンが 終了した 
ことを 通知す るた めに 呼び出される 


OnDocumentComplete 


OnDownloadBegin に 対応して、 ダウンロードの 終了を 通知す るた め 
に 呼び出される。 必ずしも 呼び出され るとは 限らない 



表 4-1 CHtmIView クラスの 彳尤表 的な メンバ 関 » 



では、 CHtmlView :: OnNavigateComplete2 仮想 メンバ 閲 数の 解説を 絞け ます 。この 仮想 
メンバ 問 数は 次のように 定義され ています。 



void CHtmlView::OnNavigateComplete2(LPCTSTR strURL) 

引数 LPCTSTR が rf/ftL 表示を 完了した URL が 格納され る 

したがって、 この 仮想 メンバ 関数を オーバーライド すれば、 自動的に 現在 表示され 
ている URL も 入手で きる という わけです。 それでは、 ClassWizard を 使って、 CHtml 
View::OnNavigateComplete2 仮想 メンバ 閲 数を オーバーライドして ください 0 



クラス 


オブジェクト ID 


メッセージ 


CBrowserView 


なし （CBrowserView を S 択） 


OnNavigateComplete 2 



表 4-2 OnNavigateComplete メンバ 関数の オ一ノ て一ライド 



次に ウインドウの キャプションへ 文字列を 設定す る 方法です が、 これには CWnd::SetWin 
dowText メンバ 関数を 使います 0 



void CWnd::SetWindowText(LPCTSTR IpszString) 

引数 LPCTSTFUpszS か ing キャプションへ 設定す る 文字列を 指定す る 




















キャプションを 設定す るた めの 関数の わりには、 SetWindowText などと いう 曖昧な 名前 付 
けがされて いるのに は 理由が あります 。実は CWnd::SetWindowText メンバ 関数は 必ずしも 
キャプションを 設定す るとは 限らない のです。 たとえば 、エディット ボックス コントロールに 対 
応 している CEdit クラスは CWnd クラスの 派 牛 •クラスで すから、 CEdit::Set WindowText 
メンバ 関数が 定義され ています が、 CEdit::SetWindowText メンバ 関数の 処理は、 エディッ 
ト ボックスに 文字列を 入力 するとい う ものです 。また、 スタティック コントロールに 対応す 
る CStatic クラスの CStatic::SetWindowText メンバ 閲 数の 処理は、 ラベル 文字列を 設定 
するとい う ものです 。これら コントロール （コントロールは すべて ウィンドウです） や ビュー 
ウィンドウを 見ても わかる ように、 ウィンドウには 必ずしも キャプションが あるとは 限り ま 
せん 。宠 際、 URLMan プロジェクトには 数々 の ウィンドウが 含まれて いますが 、キャブ ショ 
ンを 持って いるのは CMainFrame クラスに 対応す る メインフレーム ウィンドウ だけです 0 
こうした ウィンドウでは 、キャプション 以外の 文字列を 操作す るた めに Set WindowText 
メンバ 閲 数が 使われる ため、 こんな 名前に なって いるので す 0 
以上で キャプションに URL を 表示す るた めの 材料は そろいました から、 リス 卜 4-1 を 
U ながら、 先に 作成して おいた CBrowserView :: OnNavigateComplete 2 仮想 メンバ 関数を 
突 装して ください。 

リス 卜 4-1 CBrowserView::OnNavigateComplete2 仮想 メンノ 湖 H(BrowserView.cpp) 

void CBrowserView: :0nNavigateComplete2(LPCTSTR strURL) 

{ 

CString title; 

CString url (strURL); 

title = url + AfxGetAppNameO; 

CFrameWnd* pWnd - GetParentFrameO ; 

pWnd->SetWindowText (title) ; 

CHtmlView: :0nNavigateComplete2 (strURL) ; 

まず、 キャプションに 設定す る 文字列を title 変数を 使って 作ります。 Windows アブリ 
ケー シ ョンでは、 キャプションに 「< 編集 中の ドキュメント 名 > 一 < アブリ ケー ショ ン 名〉」 
と 設定す るの が スタイルで すから、 引数と して 渡された strURL 変数と、 AfxGetAppName 
関数で 取得で きる アプリケーション 名を 連結して、 文字列を 作ります。 

次に、 メインフレーム ウィンドウの キャ ブシ ョンを 変更す るた めに、 メインフレーム ウィ 
ン ドウ オブジェクトへの ポインタを CWnd::GetParentFrame メンバ 関数を 使って 取得し ま 
す 。親 ウィンドウへの ポインタを 取得す るた めの メンバ 関数と しては、 CWnd::GetParent 
メンバ 関数が あります が、 こちらは フレーム ウィンドウであろう となかろう と、 とにかく 






親 ウィンドウを 返します。 それに 対して、 CWncL-GetParentFrame メンバ 問 数は、 親 ウィ 
ン ドウが フレーム ウィンドウで なければ、 その また 親 ウィンドウを 取得して、 フレーム ウィ 
ン ドウが U っかる まで 繰り返します。 火のと ころ AppWizard が 十. 成す る スケルトンの 坳 
介、 ビュー ウィンドウは フレーム ウィンドウの ，•ウィンドウ なので CWnd::GetParent メン 
バ閲 数を 使っても M じ 結! が 抖られ るので すが、 URLMan の坳介 スプリット ウィンドウを 
使⑴ している ため、 CBrowserView 才 ブジェク 卜の ウィンドウの 親 ウィンドウは、 メイン 
フレーム ウィンドウで はなく、 スプリット ウィンドウ になって います。 そこで、 ここでは 

CWnd::GetParentFrame メンバ 間数を 使います。 

Ai 後に、 CWnd::GetParentFrame メンバ 閲 数で 取得した 才 ブジェク トボ イン 夕を 使って、 
CWnd::SetWindowText メンバ 閲 数を 呼び 川し、 キャプションの 設定は 終 T です 0 

ひとまず ここまでの 作 袋を 確認す るた め、 ビル ドして 光む してみ ましょう 。図 4-1 のよ 
うに キャ ブシ ョンに 現在 衣ポ されて いる URL が衣ボ されたら 成功です。 
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さあ、 いよいよ URLMan プロジェクトへの W 後の 作 菜になります 。ここでは、 次の 4 つ 
の メニュー コマンドを URLMan プロジェクトに Jfi 加し ます 0 



メニュー 位置 1 


オブジェクト ID 


[移動 （G>] — [次に 進む （〇] 1 


ID.GO.FORWARD 


[移動 （G)] — [前に 戻る （B>] 


ID_GO_BACK 


[移動 (G)]- [停止 (S)] 


ID_GO.STOP 


[移動 （G)] — [最 新の 情報に 更新 （R>] 1 


ID.GO.REFRESH 



表 4-3 追加す る [移動] メニュー 



まずは 図 4-2 のように、 メニュー エディ 夕を 使って、 [柊勋 ] を 穴め て 5 つの エントリを 
汜 加して ください。 ここでの 作;*; はすで に 第 2 部で 経験済み かと 思います ので、 細かな 解 
説は 将 きます。 






図 4-2 新規 メニュー コマンド 

続けて、 ClassWizard を 使って、 今 作成した 4 つの オブジェクト ID に 対応す る メッセ 一 
ジ ハンドラを 作成して ください 0 



KBSKM 








CBrowserView 


ID-GCLFORWARD 


COMMAND 


CBrowserView::OnGoForward 

■■画 ■ - — ■ 


CBrowserView 


UGO-BACK 


COMMAND 


CBrowserView::OnGoBack 


CBrowserView 


ID.GO.STOP 


COMMAND 


CBrowserView::OnGoStop 


CBrowserView 


ID.GO.REFRESH 


COMMAND 


CBrowserView::OnGoRefresh 



表 4-4 メッセージ ハンドラの 作成 



すでに 户想 がつ いている かもしれ ません が、 これら 4 つの メンバ 関数の 灾装は 非常に 簡 
嗽です。 それぞれに 必要な 処理は すべて ClltmlView クラスで 実装され ている からです。 
そこで、 一気に 実装を 終えて しまい ましょう。 リス 卜 4-2 にしたがって 人力して ください。 






リスト 4-2 メニュー コマンドに 対 JS する メッセージ 八ン ドラ （ BrowserView . cpp ) 



void CBrowserView: : OnGoForwardO 

{ 

GoForwardO ; 

> 

void CBrowserView: : OnGoBackO 

{ 

GoBackO ; 

> 

void CBrowserView: : OnGoStopO 

{ 

StopO ; 

> 

void CBrowserView: :OnGoRefresh() 
RefreshO ; 



さて、 これで URL マネージャは V こ 成、 といきたい ところで すが、 まだ 作 尨は 残って い 
ます。 丨⑴ 姐は ビル ドして、 火 行して みれば すぐに わかります。 ツリー ビューから アイテム 
を 選択して、 Web ページを 衣 小して ください。 そして、 [移勋 ] メニューを 開く とどう で 
しよう？ メッセージ ハンドラを 火 焚した はずの 4 つの メニュー コマンドは すべて グレイ 炎 
示され、 灾行 できない 状態に あるは ずです。 




図 4-3 グレイ 表示され た メニュー 
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この 現象の «(W は、 URL マネージャでは スプリット ウィンドウを 使って いるた めに、 2 
つの ビュー ウィンドウが 使われて いる ことにあります。 第 3 部の MMView を 思い出して 
ください 。この アプリケーションでは テキスト エディタと ドロー ツールを 災装 したため、 2 
つの ビュー ウィンドウが 使われて いました 。そして、 メニューは 現/ 丨 •: アクティブ になって 
いる ビューに よって、 「丨 勋 的に 切り 衿 わって いました。 これと 丨"1 じこと が IJKLMan でも 起 
こって いるので す， 2 つの ビュー ウィンドウは オーバーラップ しないた めに わかり づ らいの 
です が、 ツリー ビューの アイテムを クリックした 丨设 •問、 ツリー ビューが アクティブ になり 
ます 。したがって 、メニューは CUK じ I'reeView クラスの ものに 切り 枰わ ります。 ここに 
|l!j 题が あるので す。 先の‘ 1 つの メニュー コマンドは CBrowserView クラスに メッセージ ハ 
ン ドラと して 义焚 したので、 ツリー ビューが アクティブ になって いると きには、 [柊 動] メ 
ニューは すべて グレイに 衣氺 されて しまいます。 こうした しくみに なって いるた め、 づ丄 
Web ページが 衣， ji されて いる、 CBrowser\ iew クラスが 竹 押してい る ペインを クリック 
すれば、 [移 勋] メニュー 以 ドは 使 川 吋 能になります が、 これでは 火 川 的とは いえません。 

これは 問題です が、 解決は 維し くありません 。要は 你に CBrowserView クラスの ペイ 
ンが アクティブな ビューに なって いればよ いのです。 U •体 的には、 CBrowesrView クラス 
の ペインが JI: •アクティブ 状態に なった 瞬丨 HJ を 検出し、# び アクティブ ビューと して, 没 足す 
れば よいので す。 

ビューが 非 アクティブ になった 瞬 問を 捕らえる には、 CView::OnActivateView 仮想 メ 
ンバ lit] 数が 利 川で きます。 アクティブ ビューが W り抒 わると、 すべての ビューで この 仮 
想 メンバ 間数の 呼び 川 しが 発生し ます 。ただ、 ここでは CBrowserView クラスが 非アク 
テ イブ ビューに なった _ 間を 捉えれば よいだ けなので、 CBrowser View クラス だけで、 
CView::OnActivateView 侃 想 メンバ 関数を オーバーライド します 0 

CView::OnActivateView 仮想 メンバ 丨对 数は 次のように 迠義 されて います。 



void CView::OnActivateView(BOOL bActivate , CView* pActivateView , 

CView* pDeactiveView ) 

リ I 数 BOOL6Adt;a か この ビューが アクティブ になった とき TRUE、 非ア 

クテ ィブに なった とき FALSE が 渡される 
CView* pAc"t;a 化 V/ea; アクティブ になった ビューへの ポインタが 渡される 

CView* pDeactiveView 非 アクティブ になった ビューへの ポインタが 渡される 

このように CView::OnActivateView 仮想 メンバ 関数には 多くの 惝 報が 渡され ますが、 
ここでは とにかく アクティブ ビューが 切り 抒 わったら、 CBrowserView •クラスの ペインを 
アクティブに すれば よいので、 ごく 簡 中. な 処现で •済みます。 





ユーザーが 特定の ビューを クリック すれば アクティブ ビューは 切 り荇 わります が、 プロ 
グラム 中から 指 走した ビューを アクティブ にす るには、 CFranieWncbSet Active View メ 
ンバ閲 数を 使います 0 

void CFrameWnd :: SetActiveView ( CView * pViewNew , BOOL bNotify = TRUE ) 

引数 CView * pV 7 ew ; A ^ M ； アクティブに する ビューを 指定す る 

BOOL bNotify この 丨幻 数の 呼び出し 後、 CView :: On ActivateView 仮想 メ 

ンバ閲 数の 呼び出しを 発生させる か 指定す る 

それでは、 CFrameWnd::SetActiveView メンバ 閲 数を 使って、 表 4-5 および リスト 4-3 
のように CBrowserView::OnActivateView 仮想 メンバ 関数を 义 装して ください 0 



クラス 


オブジェクト ID | 


メッセージ 


CBrowserView 


なし （ CBrowserView を iM 択 する） 丨 


OnActivateView 



表 4-5 OnActivateView 仮想 問 数の オーバ一 ライド 



リス 卜 4-3 CBrowserView::OnActivateView 仮想 メンバ 間数 （ BrowserView.cpp) 

void CBrowserView: :0nActivateView(B00L bActivate, CView* pActivateView, 
CView* pDeactiveView) 

{ 

GetParentFrame()->SetActiveView(this, FALSE) ; 

CHtmlView: : OnActivateView(bActivate , pActivateView, pDeactiveView) ; 



CFrameWnd::SetActiveView メンバ 閲 数の 呼び出しで、 1 つ 丨丨 のリ丨 数が this になって 

いますが、 この |!41 数 呼び出しは CBrowserView クラスの メンバ 問 数で 行われて います か 
ら、 this は CBrowserView 才 ブジェク 卜を 指して います。 すなわち、 メニュー コマンドの 
メッ セージ ハンドラが 介: 合: する CBrowserView の ペインを アクティブに する ことを 指示し 
ています 〇 次の 引数が FALSE になって いますが、 これは CFrameWn 士 Set ActiveView 
メンバ 閲 数の 呼び出し 後、 再び CView::OnActivateView 仮想 メンバ 関数の 呼び出しが 発 
生し ないように 指示して います 0 この 実装では 無条件に CFrameWnd::SetActiveView メ 
ンバ閲 数を 呼び出し ている ため、 この リ丨 数に TRUE を 指定す ると、 無限ループが 発 4: して 
しまうた め、 これを 防ぐ ために FALSE を指龙 します。 

以丨 ••で ツリー ビューを クリックしても、 CBrowserView の ペインが アクティブ 状態に 維 
持され るよう になり ましたが、 URL マネージャを 实 行した 商 後には、 ツリー ビューが ァク 
ティ フ になっ てし まって います 。これは CMainFrame::OnCreateClient 仮想 メンバ 関数を 
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火 焚した とき、 スプリット ウィンドウへ ビューを 仲人す る K(( 添 1 が CURLTreeView クラス 
が 先だった からです 。この) «(糌 は そのまま ペインの 也び 恥に つながる ため、 初期 状態では 
必ずん: 側の ペインが アクティブ になって いまいます 。そこで、 初期 状態を 変 1 上す るた めに、 
CBmwserView に Onl 丨化 ialUpdatcMU 想 メンバ 閲玫 に、 次の 1 行を 追加して ください 。これ 
で、 初期 状態で も CBrowserView の ペインが アクティブになります 0 



リス 卜 4-4 OnlnitialUpdate 関数 （ BrowserView.cpp) 

void CBrowserView: :OnInitialUpdate() 

{ 

Navigat e2 ( .T ( M about : blank 11 ) , NULL , NULL) ; 
GetParentFrame()->SetActiveView(this, FALSE) ; 



さあ、 今度 こそ 本、 1 彳 に ukl マネージャの 义装は 終 r です。 v •速 ビル ドして、 义 行して 
みて ください 。今哎 はちゃん と [移#] メニューが 常に 使 川" f 能に なった はずです。 これ 
で WWW ブラウザ としての 体 成 も 格い ました 〇 HTML コントロールを 使 川す る ことで、 
Web ブラウジング アプリケーションが どれ だけ 簡丨 i 1 •に 作成で きる か、 おわかり になった で 
しょう か？ • 




え マウス 
プレゼン^ 中 



C8NTENTSMAP 
ASCII 24 



図 4-4 URL マネージャ、 ホン 卜に 完成の 図 
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避けて は 通れない 

C ++ 言語の 基礎知識 



c+ + u 語は 非常に 複雑な 処理 系です から、 ここで その すべてを 解説す る ことは 到底で 
きません。 また、 本格的に C+ + •語を 使いこな すには、 オブジェクト 指 叫 ブ ログ ラミン 
グに 関する 知識 も 必須と いえます。 ただし、 Visual C+ + という 枠組みの 中では、 ごく 限 
られた 知識で あっても、 ブロ グラムを 作成す る ことは 吋 能です。 そこで、 ここでは Visual 
C + + を 使って プログラムを 作成して いく 丨 •.で 必要になる 知 熾に ついての み, 说明 する こと 
にします 。よって、 いくつかの 仕様 （言語 上: t 要で あるか もしれ ない が本诲 では 必要と し 
ない 什 様） について は 説明を 竹き ます。 



A .1 構造体と クラス 

C+ + 言語は CH 語に いくつもの 拡张を 施した プログラミング 言語です が、 その 拡張の 
中心的な 存 介: が クラスです 。拡張され た仆 様の ほとんどが クラスの 芬 人に 伴う ものと いっ 
て も 過 J ではありません。 クラスを 邢 解す る ことが、 C++U 語を 理解す る ことの 第一# 
となる ことは いうまで もありません。 

さて、 それでは クラスとは いったい どういう ものな のでし よう 〇 丨 •.っ 丨〖丨 丨 だけを 兄れば、 ク 
ラスは 構造体を 拡張した ものと いった 体 放を 持って います 。そこで、 まず 構造体と クラス 
を 比較して みる ことにし ましよう。 

iii •初に、 丨"1 じ処现 を 構造体と クラスの 内方を 使って # いてみ ます。 処理 内祥 は、 指定し 
た文卞 列の 先頭から 指定した 文字 数 だけ 表示 するとい う ものです 。構造体と クラスの 定義 
と 利用 例を リス 卜 A-1 に 示します。 






確かに H となく 似て はいます が、 クラスの 定 在には、 いろいろと 兄た ことのな い キー ワー 
ド や 表記が いくつかあります。 W •た H で わかる 違いは 

•クラスには、 メンバに 間数の プロトタイプ 穴 j が 沿 加され ている 
•クラスには、 private、 public といった キーワードが 使われて いる 
•クラスの 才 ブジェク 卜の 定 在には、 class キーワードは 使われて いない 

といっ たと ころです。 もちろん、 ここに あげた 迫い は义 •法 上の 迫いで しかな く、 その 本饺 
は 一歩 誤れば 泥沼に 沈み こんで しまう ほど 深い ものです。 

ところで、 ここでは 偁造 体と クラスを 比較しながら クラスの 説明を 行って いきます が、 
ここでい う惝造 体とは あくまでも C 3 語での 構造体で ある ことに 注总 してく ださい。 とい 
つのは、 C ++ ij •語では struct キーワード によって 定在 する 構造体に ついても、 dass キー 
ワードで 定在 する クラスと ほとんど M じ 働きを する ように 拡张 されて いるから です。 
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A .2 メンバ 関数と アクセス 制御 

構造体と クラスの 人き な 違いの 1 つに、 クラスでは メンバと して 閲 数を 定義で きる とい 
う ことがあ げられ ます。 この 問 数の ことを メンバ 関数と 呼びます 。それに 対して、 従来の 変 
数の メンバを メンバ 変数と 呼びます 。偁造 体の メンバに アクセス するとき には アクセス 演兑 
子を 使って、 「<構 造体才 ブジェク 卜 >.< メンバ >」 または 「< 構造体 オブジェクトへの ポ 
インタ >-> く メンバ〉」 としまし たが、 クラスの 場 介で も" 法は 叫 じです。 つまり、 「くク 
ラス 才 ブジェク 卜〉 •く メンバ〉」 または 「く クラス 才 ブジェク 卜への ポインタ >_> くメン 
バ>」 として アクセス します 。この ことは、 メンバ 閲 数を 呼び出す ためには、 その メンバ 
間数が 妬して いる クラスの オブジェクトが 必要 だとい うこと を总 味して います。 

たとえば、 表示す る 文字列を 設定す る 問 数、 SetMessage 閲 数を 考えて みましょう。 構 
造 体を 使った 坳 合には、 

struct sString message; / •搆造 体 オブジ 1 ク 卜の 定拜 •/ 

SetMessage(&message, "hogehoge"); /• SetMessage 間数の 呼び出し •/ 

と、 閲 数に 才 ブジェク 卜の アドレスと 設定す る文卞 列を 渡す のに 対して、 クラスの 場合は、 

cString message; // クラス 才 ブジェク 卜の 定義 

message . SetMessage ( M hogehoge H ) ; // メンバ 問 数、 SetMessage 間数の 呼び出し 

と、 才 ブジェク 卜に 対して メンバ 問 数と して 走義 されて いる SetMessage 閲 数を 实行 して、 
义卞 列を •没 泡す るよう になります 。惝造 体の 才ブジ ヱクト を定在 するとき には struct キー 
ワードが 必要で したが、 クラスの 才 ブジェク 卜を 定在 するとき には dass キーワードは 必 
盟な いこと にも 注 总 してく ださい。 

偁造 体の ように メンバの 侦を丨 1*( 接设记 する 代わりに、 メンバ 閱 数を 使って メンバ 変数を 
挽 作 すれば、 各 データの 格 介 性を 保つ ことができます 。たとえば、 cString クラスでは、 
mjen には 文字列 （m_str) の ii さを 保存して いますが、 その 関係は あくまでも そのよう に 
使われる ことが 期待され ている だけです 〇 文 •字 列を SetMessage 関数を 使って 設定 すれば、 
その 文字 数が mjen に 保# され、 データの 幣合 性が 保たれる でしょう 。しかし、 2 つのメ 
ンバ 変数の 侦 をめ: 接 変 史 してし まえば その 幣介 性が 保たれる 保証は どこに もありません。 
利⑴ する 側が、 そうした 使い 力 •（ルール） を 守らなければ ならない のです。 この ルールを 
守っ て、 データの 幣介 性を 保って くれる のが メンバ 関数な のです。 

ところが、 メンバ 間数を 使わずに メンバ 変数の 侦 をめ: 接、 設定で きる ようでは 整合性を 
完全に 保つ ことは できません 。そこで、 C++ 言語には メンバ 変数を 保護す るた めに、 ク 
ラス 外から メンバへの アクセスを 制限す る 力 •法が 州 意され ています 。各 メンバに 対して ど 
一からの アクセスを, i 午丨 ij * する かを 指 走す るた めに 使う のが、 キーワード や pubjjc 
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キーワード といった アクセス 指定 子です。 public キーワードを 使って パブリック 诚 性を 指 
走した メンバ （パブリック メンバ） には、 オブジェクト さえ あれば プログラムの どこからで 
も mil に アクセス できます。 一み 、 private キーワードを 使って ブライべ ー卜诚 性を 指定し 
た メンバ （プライベート メンバ） は、 丨 じ クラスの メンバ 閲 数から しか アクセスで きませ 
ん 。つまり、 他の クラスの メンバ 閲数や グローバル 問 数からは アクセスで きないよ うにな 
ります。 これらの 诚 竹: は、 メンノ く 中. 位に 指定で きます。 

つまり、 パブリックな メンバ 問 数は クラスの 外から メンバ 変数を 操作す るた めの イン 夕 一 
フェイスに 相、 レ丨 し、 プライベートな メンバ 間数は クラス 内部で 閉じた 操作を 行うた めに 利 
川す る ものと 名 •える ことができます （図 A -1)。 




インターフェイス として 機能す る 



図 八- 



と ころで、 ブライべ ート メンバし かない クラスが あった としたら、 その クラスの オブジェ 
ク 卜を 作 っても、 その あとは 何もで きません 。というのは、 ブライべ ート メンバに アクセ 
スす るた めには、 パブリックな メンバ 問 数が 必要 だからです 。逆に、 ある クラスの メンバ 
がすべ て パブリック メンバだった としたら 、誰でも メンバ 変数を いじ くれてし まいます か 
ら 、メンバ 問 数なん ていら なくなって しまいます。 この 状況は 構造体と そっくりです。 实 
際、 c + + ; i 語では、 惝造 体の メンバは アクセス 指 走， •を 使って その 祕 性を 指 走し なか っ 
た坳 介には、 パブリック メンバと して 扱われます （逆に いえば、 c + + H 語に おいては 構造 
体の メンバで も プライベート 妬 件を 持つ ことができる ことを 总 味す る）。 クラスの メンバに 
閲 しては、 诚 性を 指 走し なければ ブライべ 一 卜 メンバと して 扱われます， 

リス 卜 A -1 に 示した cString クラスの 例で あれば、 m _ str 、 mjen の 2 つの メンバ 変数 
と SeAength 丨 知 数が プライベート メンバ 、 SetMessage IKJ 数と PrintMessage 関数の 2 つ 

の メンバ 間数が パブリック メンバと して 定義され ています。 cString クラスの メンバ 恋 
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数、 m_str と mjen を 喪 き 換える ことができ るのは、 SetLength 閲 数、 SetMessage 関数、 
PrintMessage_ 数の 3 つの メンバ 関数 だけです 。それ 以外の 関数からは 参照/変更 ともに 
できません。 また、 SetLength 問 数を 呼び出す ことができ るのは、 cString クラスの 3 つの 
メンバ 閲 数に 似られます （SetLengthlSimn 身を 穴む） 。パブリック メンバの SetMessage 
丨对 数と PrintMessage 閲 数は、 才 ブジェク 卜さえ あれば、 ブロ グラム 中の あらゆる 場所 か 
ら呼び m す ことで きます。 

A .3 メンバ 関数の 実装 

今までの ふ 1 ; •を まとめる と、 メンバ 問 数の 特徴と して 以 ドの ような ことがあ げられ ます。 

•プライベート パブリックを 問わず、 M じ クラスの すべての メンバに アクセス 町 能 

•クラス オブジェクトがなければ 呼び出し イく吖 能 

ここで、 これらの 朴徴 に加えてもう 1 つの メンバ 丨 it] 数の 特徴を 説明し ます。 

♦ メンバ 関 数の 中から M じ才 ブジェク 卜に 诚 している メンバに アクセス するとき には、 
才 ブジェク 卜を 指 走す る 必要は ない 

coring クラスの オブジェクト、 message を 使って SetMessage 閲 数から SetLength 閲 
数を 呼び 丨丨丨 す ことを 冬え てみ ましょう。 message オブジェクトを 使って、 Uf •び 出された 
SetMessagelW 数の 中から、 さらに SetLengthIKI 数を呼 び 出す には、 やはり message オ 
ブジェク 卜を 使って 問 数を Hf び 出す 必要が あります 。というのは、 メンバ 変数の 侦は それ 
ぞ れの才 ブジェク ト によって 饵 なる からです 0 また m _ str 々 m j e n に アクセス する 坳 介に 
も、 message 才 ブジェク 卜を 介して アクセスし なければ いけません。 

しかし、 SetMessage メンバ 閲 数を 記述す る 時点では 、オブジェクトの 名前は わかり っ 
こありません 。そこで、 メンバ _ 数の 中から 丨》1 じ クラスの メンバを アクセスす る垛 介には、 
メンバ 関数を 呼び 川した 才 ブジェク 卜を 使って その メンバ 丨 阳 数を 呼び出す ように、 コンパ 
イラが 的に 処 列！ して くれます。 このため、 メンバ 問 数の 中では、 オブジェクトを 指定 
せずに メンバを アクセス できる のです。 

この 処邱 •のからく りは、 this ポインタ という 特殊な ポインタを 淖入 する ことによって 突 
现 されて います。 this ポインタは、 メンバ 問 数を 呼び出した オブジェクトを 指す ポインタ 
のこと で、 呼び出された メンバ 間数 内での み 参照が uf 能です。 ですから、 this ポインタの 
® は、 cString クラスの メンバ 関数の 中では c String*M です し、 MFC が 提供す る CFile ク 
ラスの メンバ 関数の 屮 では CFile* 喂 となります 3 つまり、 すべての メンバ 問 数には、 略 •黙 
のうちに リ丨 数と して this ポインタが 渡されて いると 考える ことができます。 
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以上の ことを 踏まえた 上で、 cString クラスの メンバ 閲 数の 実装 例を 兄て みましょう （リ 

スト A-2)〇 



リス 卜 A -2 メンバ 関数の 実装 

void cString: :SetLength(char* s) 

{ 

// 文字列の 長さを m Jen に 設定 

m.len = (s != NULL) ? strlen(s) : -1; 



void cString: :SetMessage (char* s) 

{ 

if (s != NULL) { 

SetLength(s) ; // cString::SetLength を 呼び出す 

m_str = new char[m_len]; // 文字列を 保存す る メモリを 確保 
strcpy(m.str, s) ; // 文字列を コビー 

} 

> 

void cString: : PrintMessage(int n) 

{ 

if (m.str != NULL) 

// 指定した 文字 数と mjen の 小さい 方の 文字 数 分 だけ 表示 
printf ("*/•. *sYn", min(n, m.len) , m.str) ; 



メンバ 丨 Stl 数は、 クラス. 定義の 内部で 欠 装 （閲 数の コードを 紀 述） する こと もで きます し、 ク 
ラス 定義の 外部で 実装す る こと もで きます 0 外 部で 灾 装す る坳 合には、 問 数名は 「 :: 演 ぬ: 子 （ス 
コーブ 解決 子）」 を 使って、 < クラス 名 >::< メンバ 閲 数名 > の 形式で 指定し ます。 メンバ 閱 
数の 名前は、 クラス 内部で ローカル であるた め、 クラス 走 在の 外で メンバ 閲 数の 実装を する 
際に、 その 関数を 一 总 に 衣す ためには、 クラス 名 も 含めて 閲 数名を 指定す る 必要が あるから 
です 。たとえは、 cString クラスの メンバ 関数、 SetMessagelW 数は 「cString::SetMessage 
閲 数」 と 表現され ます。 
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cString::PrintMessage 関数は、 呼び出される 前に c String::SetMessage IKJ 数に よって あ 

ら かじめ 文字列が 設定され ている ことを 前提に 記述され ています 3 しかし、 才 ブジェク 卜 
を 走義 した 丨* k 後に、 あえて 文字列を 設定せ ずに、 cString::PrintMessage 閲 数を 突 行したら 
どうなる でしょう？ 才 ブジェク 卜の 定在丨 後は、 メンバ 変数は まだ 探 作され ていな いため、 
その 侦は +定 です 。したがって、 まったく わけの わからない 义卞 列が 衣ポ されて しまう か 
もしれ ません 。これは 非常に 危険な ことです から、 オブジェクトの 作成 丨 丨リ: 後に、 メンバ 変 
数の 初期化を 火む する ことが 装になります 。コンストラクタは、 このような 丨丨 的で 利 川 
される 特殊な メンバ 関数です。 

C++ H 語では、 クラスの 才 ブジェク 卜を 作成す ると、 すぐに その クラスの コンスト ラ 
ク 夕が 呼び/ 丨丨 されます 。コンストラクタは メンバ 間数では あります が、 以 ドの 2 つ の 点が 
他の メンバ 関数とは 興なります 0 

參 返り 侦は 持たない 〇 void とも 違い、 沏の 指定 すら 行わない 
♦コンストラクタの 名前は クラス 名と 丨 じ 

コンストラクタ である ことを, j; •す キーワードは とくにありません。 その メンバ 間数が コ 
ンス トラクタ である ことを、 コンパイラは 問 数名と 返り 侦が ない ことから 判断し ます 
それでは、 cString クラスに コンストラクタを 迟加 してみ ましょう （リス 卜 A-3>〇 この 
クラスの コンストラクタは、 メンバ 変数に 初期 侦を 代人す る だけの 非常に 中 純な ものです 

しかし これた けで、 才 ブジェク 卜を 作成した ときには すでに、 心 •幼な 侦を 持って いる こと 
が 保証され ます。 

U ス卜 A -3 コン ス卜ラ クタ 

class cString { 

• ••略 
public: 

cStringO; // コンストラクタ 0 返り 値は 持たない 

• ••略 

} 



cString: :cString() 



374 



A 避けて は 通れない C ++ 言語の 基礎知識 



cString message; 

message.PrintMessage(5) ; // 何も 表示され ないだ け 



次に クラス 才 ブジェク トの勋 的な 作成に ついて ちえて みましょう 。たとえば、 以ド のよ 
うにして、 cStri 丨 クラスの 才 ブジェク 卜を ヒープ 丨 •.に 確保し ます。 

cString* pro = (cString*)malloc(sizeof (cString) ) ; 

pm_>Pr intMessage (5) ; // 結果 不定 

才 ブジェク 卜を 作成す ると コンストラクタが 呼び 丨 h される といっても、 このような ときに 
は コンストラクタが 呼び 川され る ことはありません。 なぜなら、 ma 丨丨 〇C 関数を 使って 作っ 
た才 ブジェク 卜は、 あくまでも s i zco f(cSiring> バイトの メモリ M 域であって、 cString ク 
ラスの 才 ブジェク 卜では ないから です。 丨 |彳. に 確保した メモリ 箾 域への ポインタを c StrinK 
クラスの 才 ブジェク 卜への ポインタに キヤ ストして いるに すぎません。 コンスト ラク 夕に 
よる 初期化 もむ われません し、 このん •法は オブジェクトの# 的な 卞 成" 法と して 適切な も 
のとは いえない でしょう そこで、 C+ + •丨 は オブジェクトを 動的に 作成す るた めに、 
malloc 聞飲 に 代わって、 new 演 tU. が 川 立され ています 0 

先の 例を new 演 灯 f •を 使って# き 換える と、 

cString* pm = new cString; 

pm->PrintMessage(5) ; // 何も 表示され ないだ け 

となります 。このように 丨 ie\v 演灯户 を 使って オブジェクトを 作成す ると、 コンストラクタ 
が 呼び m され、 き ちんん と 初期化が 行われる ようになります。 C+ + 1 丨 •，沿で オブジェクト 
を 確保す る坳 介には、 かならず new 演 «:户 を 使うよう にして ください。 

new 演灯户 は、 才 ブジェク 卜の 喂を 〇 ••える と必毋 な サイズの メモリを 確保し、 確保した 
メモリ 箾 域への ポインタを 返します が、 オブジェクトの 咽を 指记 する" 法には、 いくつか 
の 形式が あります。 

1. new <才 ブジェク トの喂 > 

2. new <才 ブジェク 卜の 喂〉 （コンストラクタの リ丨 数} 

3. new < 才 ブジェク 卜の 咽〉 [配 列の サイズ] 

1 •の 形 ス; では、 int、 char、 クラス 名と いった 才 ブジェク トの咽 を 与えます。 この場合は、 
リ丨 数を 持たない コンストラクタが Hf •び 川され ます 0 2 •の 形式では、 リ | 数を 持っ コンスト ラ 
クタが 呼び出されます 3 3 •の 形式は、 オブジェクトの nil 列を 確保 するとき に 使います。 こ 
の坳 介には リ丨敉 を 持つ コンストラクタを 呼び出す ことは できません 。このと きには リ丨 数を 
持たない コンストラクタが かならず 呼び出されます。 
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A .5 デス トラクタと delete 演算子 



オブジェクトを 作成した め: 後に コンストラクタが 卟 び 出された ように、 オブジェクトが 
破壊され る丨 | •(前には、 デス トラクタが 呼び出されます。 デス トラクタ もやは り コンスト ラ 
クタと 丨"1 じように 特殊な メンバ 閲数 であり、 次の ような 特徴を 持って います。 

♦返り 値は 持たない。 void とも 違い、 S? の 指 走 すら 行わない 
♦引数を 取る ことは できない 

•クラス 名の 丨 i;j •に ~ (チルダ） を 付けた 名前が デス トラクタの 名 別になる 



メンバ 変数に# 的に 確保した メモリ や オブジェクトが あるときには、 その クラス 才 ブジェ 
ク 卜が 破壊され る 前に# 的に 確保した メモリ や才 ブジェク 卜を 解攸 しなければ いけ ませ 
ん。 たとえば、 cString クラスでは、 cString::SetMessage 閲 数で 文 卞 列を コビーす るた め 
に new 演兑广 を 使って メモリを 確保して いますが、 行谈 の恶 いこと にこの メモリの 解放を 
さ ぼって います。 こういった メモリの 解放な どを 行う のに、 デス トラクタを 使います。 

C では、 malloclW 数で 確 W した メモリ？ m 或は、 他い 終わったら freelil) 数を 使って 解 
放しなければ いけませんでした 〇 C+ + ,丨 •，沿では 励 的に メモリを 確保す るには、 malloclW 
数では なく new 演 灯す •を 使います が、 使い 終わった メモリを 解放し なければ ならない とい 
うことは C ポ 語と まったく N じです 。ただし、 new 演 t): チで 確保した メモリは、 free 閲数 
ではなく delete 演算子を 使って 解放し ます。 

delete 演 灯， •は、 才 ブジェク 卜への ポインタを 受け取り、 その ポインタが 指す オブジェ 
ク 卜を 解放し ます。 そして、 V. えられた オブジェクトの 喂に 応じて、 適 W な クラスの デス 
トラクタを 呼び 川 します。 なお、 delete 演 は演筘 子です が、 返り 侦は ありません。 

delete 演 灯， •に才 ブジェク 卜への ポインタを •える ときには、 ポインタが fid 列を 指して 
いるか どうかで 以 ドの 2 っの 形式を 使い分けます,， なぜなら、 もし ポインタが 妃 列を 指し 
ている のなら ば、 fli! 列の 炎ぶ 1 つ 1 つに 対して デス トラクタを 火 行し なければ ならない か 
ら です。 もし 才ブジ ヱ クトの 妃 列に 対して iii •初の 形式の デス トラクタを 火む すると、 fld 列 
の 先頭の 要素 だけし か 解放され ません から 注愆 してく ださい。 

1. delete < 才 ブジェク 卜への ポインタ〉 

2. delete []< 才 ブジェク 卜の ft! 列への ポインタ〉 

それでは、 cString クラスに デス トラクタを 灾装 してみ ましょう 。加えて ここでは、 
cString::SetMessage 関数を 使って 文字列を 設走 するとき に、 すでに 文字列が 設定され て 
いる 場合には 山 •い 文字列を 解放す るよう にします。 
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リス 卜 A -4 デス 卜 ラ クタ 



class cString { 

< 省略 > 
public: 

CStringO; // コンストラクタ 
•CStringO; // デス トラクタ 

}； 



void cString: :SetMessage^char* s) 

{ 

if (m_str != NULL) 

delete m.str; "古い 文字列を 解放す る 

if (s != NULL) { 

SetLength(s) ; //cString::SetLength を 呼び出す 

m_str = new char[n^len]; // 文字列を 保存す る メモリを 確保 
strcpy(m.str, s) ; // 文字列を コビ - 

} else { 



m^str = NULL; 

m_len = -1; //mjen = - 1 は 文字列が セットされ ていない ことを 表す 



void cString:: cStringO 

{ 

delete [] m.str; //char 堅の K 列を 確保して いたた め、 K 列と して 解放 

} 



A .6 クラスの 継承 

本節と 次 節では、 第 1 邰 2 0 で 作成した Hello プロジェクトを 例に して 説明を 進めて い 
きます。 

AppWizard が 生成した He 丨 1〇上 には リス 卜 A-5 に 示す ように、 CHelloApp クラスが 定 
我され ています。 すでに 説明した クラスの 定義とは 少し 違い、 クラス 名の あとに 「： public 
CWinApp」 と 付いています。 これは、 CWinApp クラスを もとにして、 新しく CHelloApp 
クラスを 定義す る、 という ことを 衣して います。 このよう にある クラスを もとにして 新し 
く クラスを 记在 する ことを クラスの 継承と 呼びます 。このと き、 もとに なった クラスを 基 
底 クラスと 呼び、 佐 底 クラスを 継承して 新しく 走 •没した クラスを 派生 クラスと 呼びます 0 
ここでは、 CWinApp クラスが 基底 クラスで、 CHelloApp クラスが 派 也 クラスです。 
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リスト A -5 CHelloApp クラスの 定義 



class CHelloApp : public CWinApp 

{ 

public : 

CHelloAppO ; 

// 才一 バーラ イド 

// ClassWizard は 仮想 関数の オーバーライドを 生成し ます 

//{{AFX_VIRTUAL(CHelloApp) 

public : 

virtual BOOL InitlnstanceO ; 

//>}AFX_VIRTUAL 

//インプリメンテーション 

//{{AFX_MSG(CHelloApp) 
afx.msg void OnAppAbout () ; 

// メモ - ClassWizard はこの 位* に メンバ 関数を 追加 または 削除し ます 
// この 位 ® に 生成され る コードを « 集 しないで ください。 

//>}AFX.MSG 
DECLARE.MESSAGE.MAP ( ) 



派 叱 クラスの 特徴は、 派 ，丨: •クラスの メンバには 接 嵌 クラスの メンバが すべて 念 まれて い 
ると いう ことです。 たとえば、 CHelloApp クラスでは 2 つの メンバ 問 数 （コンスト ラク 夕 
と InitlnstancelW 数） しか 穴,? されて いません が、 この クラスは CWinApp クラスから 派 

している ので、 CWinApp クラスの メンバ 変数と メンバ 閲 数の すべてを、 その メンバに 
^ん でい ます。 ただし、 派 中 •クラスの メンバ 問 数が アクセス できる 浓底 クラスの メンノ くは、 
パブ リツ ク メンバ だけで、 丛歧 クラスの ブライべ 一 卜 メンバに アクセス する ことは でき ま 
せん 0 

このように クラスを 継承す る ことによって、 敁小陨 の； f •問で 必费な 機能を 持った クラス 
を 作る ことができます。 



A 避けて は 通れない C ++ 言語の 基礎知識 



A .7 仮想 関数 

派 十. クラスの オブジェクトは 从豉 クラスの パブリックな メンバ 閲 数を すべて 利 ⑴で きま 
すが、 丨"1 名の 問 数が 派 十. クラスと 丛豉 クラスの 丨山 i " で a ぶされ ていたら どうなる のでし ょ 
うか？ たとえば、 Initlnstance 関数は、 CWinApp クラス （蘇 底 クラス） と CHelloApp ク 
ラス （派 卞 クラス） の丨 •丨 リノ/ で定 在され ている 閲 数です。 このような 場 介は、 人ノ / の 予想 ど お 
り、 派 クラスの メンバ 間数が 俺 先 的に 呼び出されます 〇 CHelloApp クラスの 才 ブジェク 
卜を 使って Initlnstance 閲 数を 丨丨 f び 川す と、 CWinApp クラスの Initlnstance 閲 数では な 
ぐ CHelloApp クラスで 新たに 走 •没し め: した Initlnstance 閲 数が 呼び 川 される のです 0 

ところで、 C + + , i •如では 以 ドの ような ことが 許されて います 0 

籲派 卞 クラスの オブジェクトは、 キヤ ストな しに 从成 クラスの オブジェクトに 代人で きる 

ここで 叫! ifl です 〇 ClIelloApp クラスの 才 ブジェク 卜を CWinApp クラスの オブジェクト 
に 代人した 場合、 この オブジェクトを 使って Initlnstance 問 数を 呼び出す と、 どちらの ク 
ラスの Initlnstance 数が 呼び 川され るので しょう？ 

もし CWinApp クラスの InitlnstanceWl 数の uj に virtual キーワードが 指记 されて い 
なければ、 CWinApp :: InitInstancel 5 y 数が 呼び 川され ます 。っまり、 基底 クラスの 才 ブジェ 
クト に派卞 クラスの オブジェクトを 代人す ると、 オブジェクトを 走 在した ときの クラスに 
閲係 なく、 丛政 クラスの オブジェクト として 勋作 するとい うこと です。 

ただし、 Initlnstance 問 数が virtua 丨 キーワードを 使って 宣 撐 されて いたら、 才 ブジェク 
卜の 咽は CWinApp クラスで も、 CHelloApp :: InitInstance 閲 数が 呼び 川 されます 0 

そして、 火 際のと ころは、 CWinApp :: InitInstance 関数は virtua 丨 された 閲 数です 0 
よって、 この場合は、 CWiiiApp クラスの オブジェクトに ClIdloApp クラスの 才 ブジェク 
卜を 代人しても、 才 ブジェク 卜の 喂 （ CWinApp クラス） に閲 係な く、 代人 尤の才 ブジェク 
トを记 衣した ときの クラスの メンバ 閲数 （ CHelloApp こ Initlnstance 関数） が 呼び 川 され ま 
す 〇 CWinApp :: InitInstance 間数の ように、 virtual u ,4 ■された メンバ 関数の ことを 仮想 関 
数と 呼びます 。そして、 从成 クラスの 仮想 間数を 派生 クラスで 冉 定義す る ことを、 「仮想 
問 数の オーバーライド」 といい ます。 

メンバ 閲钕が 仮想 関数で あるか どうかは、 丛政 クラスでの 閲 数の プロトタイプ 穴 n •に 依 
む: します。 丛成 クラスで 仮想 閲数 として 穴, i •されて いれば、 派 中 クラスで も 仮想 問 数と し 
て 扱われます 〇 CHel 丨 oApp クラスの 泣 在 （リスト A -5) では Initlnstance 閲 数を 仮想 関数 
として kH •してい ますが、 この 垛 合の virtua 丨 キーワードは あっても なくても M じと いう 
ことです。 仮想 間数を 寅 言 するとい うことは 、「網 承され る ことを 前提と して 設計され た 
クラスに おいて、 その 派 z |:. クラスの メンバ 閲玫を 呼び出す ための 抜け 泣を 川. な して おく」 
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ことで あると いえます。 

加えても う 1 つ、 仮想 間数には t 要な 仆様 があります 。それは、 「仮想 関数を 使って 灾際 
に 呼び出される 閲 数は、 プログラムを 戈 行す るまで 決 沿され ない」 という ことです， たとえ 
ば、 CWinApp クラスの オブジェクトを 使って Inhlnstance 閲 数を 呼び 丨丨丨 す 場 作、 その 才 
ブジェク トがイ く、 1 ' 丨に CWinApp クラスの 才 ブジェク 卜な のか、 派 , 丨： クラスの オブジェクト 
なのかに よって、 火 際に 呼び, 1 丨{ す 関 数が 変わって くるから です， このため、 すでに コンパ 
イル 済みの コードで あっても、 奴 想 関数で あれば あとから 作成した 問 数を 呼び 丨 h す ことが 
できる のです。 このような、 文 行中に 呼び 川す 閲 数を 決 记 する ことを 動的 結合 （Dynamic 
Binding) と 呼びます 。これに 対して、 コンパイル 丨丨 $に呼 び 川す 丨对 数を 決定す る ことを 静的 
結合 （Static Binding) と 呼びます。 



A .8 その他 

木 節では クラスとは 丨丨 •( 接閲 係の ない、 C+ + •丨 ••沿で; £1 加され た f|: 様を 3 つ 取り 丨 •. げるこ 
とに します。 

® 才 一 パ 一 ロ 一 ド 

C •丨 丨 では、 l"j じ名丨 •丨: j •の 間数を 1 つの プログラム 内で 松 数 作る ことは できませんでした 0 
."、 C+ + ■丨 では、 メンバ 閲钕の 名前は クラス 内で ローカル なので、 クラスが 迠え ば、 
M じれ 阶 の 丨幻 数を 作る ことができ るのは すでに 述べた とおりです 。それ どころ か、 |nj じク 
ラス 内で さえ、 丨… じ 名前の 丨 划钕 を 作る こと も UJ* 能です （クラス 内では なくても 、つまり グ 

ローバ ル閲 数で も" f 能) 。このように、 阀 じ 名前空間の 中で 丨"1 じ 問 数名を 持つ 問 数を 走 在す 
る ことを 関数の オーバーロード と哼 びます D 

もちろん、 名は おろか 返り 侦の喂 や， j 丨 数まで すべて 丨"1 じ丨 iy 纹を梭 数 定義す る ことは 
できません。 C+ + “ 語では 関 数名 返り 侦リ丨 数と 3 つの 条件が マッチした 閲 数が 呼び 川 
される からです （C I 丨甜 では 閲 数名 だけを 使って 呼び出す 間数を 特记 していた）。 したが っ 
て、 デス トラクタ のように リ I 数 も 返り 侦も 持たない 問 数は、 オーバーロードで きません 

_ デフ ォル 卜 引数 

C+ + H •語では、 竹略丨 If 能な リ丨 数を 持った 問 数を 定義で きます 。このような リ丨 数の こと 
を デフ ォルト 引数と 呼び、 リ丨 数の 指定を VT 略して 閲 数を 呼び出した ときには、 プ ロト タイ 
プの ug •時に 指 走した 侦がリ I 数と して 使われます 3 

デフ ォルトリ 丨 数は 関数の プロ 卜 タイプ' r( •丨 •のとき に 次のようにして •没 记 します。 
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void Setup (char* name = NULL, int value = -1); 
void Setup (char* name, int value = -1); 

しかし、 次の ような 茛 言は できません 。デフォルト 引数は、 引数の 末尾から 順に 抜けが 
ないように 設定す る 必要が あります。 

void Setup (char*name = NULL, int value) ; 

W •初の 例に あげた プロトタイプ 穴 H をした 場 介、 次の IW 数 呼び出し はすべ てこの Setup 
丨对 数を 呼び出す ことになります 。记 りない 引数に ついては、 デフ ォルト 引数が 与えられた 
とみな されます。 

Setup 〇 ; "Setup(NULL. -1); と 同 « 

Setup( "Visual C++"); // SetupfVisual C++”， -1}; と 同様 

SetupC'Visual C+-f", 8); // Setupf Visual C+-f - . 8); 

しかし、 次の ような 関数 呼び出しは できません 。デフォルト 引数を 持った 関数を 呼び出 
す坳 合には、 リ丨 数の 先頭から 順に 抜けがない ように 与える 必要が あります。 

Setup(, 8); 

なお、 デフ ォルトリ I 数を 持った 閲 数を 走 在す る坳 介には、 そのこと を はっきりさせる た 
めに、 次のように コメントで デフ オルト 値を 記述して おくと よいで しょう 0 

void Setup(char* name /* = NULL */, int value /* = -1 */) 

{ 

く Setup 関数で 処理す る 内容〉 

> 



春 参照 

C++ 言語では 、ポインタ によく 似た 参照が 新たに 導入され ています。 詳しい 説明を 始 
める 前に、 ポインタと 参照の 両方を 使って、 同じ 処理を 行う ブロ グラムを 見て ください。 

リス 卜 A -6 费 照と ポインタ 



// ポインタを 使用 
int var - 1; 
int* ptr = &var; 
printf("%d", *ptr); "1 を 表示 
*ptr=2; 

printf (•••/•(!••, var) ; //2 を 表示 



// 参照を 使用 



A .8 その他 



int& ref = var; 
printfdd", ref); // 1 を 表示 
ref = 2; 

printf (•••/•(!••, var); // 2 を 表示 



リス 卜 A-6 を兑た 限りでは、 参照は 「ポインタが 指す オブジェクトに アクセス するとき 
に 使う 間接 演兑 f (*) を 不要に した もの」 または 「指定した 変数の 別名」 であると いえます 0 
これが 何の 役に立つ のでしょう？ 

参照は k に、 IH ] 数の リ丨 数と 関数の 返り 侦に活 躍し ます。 参照を 使って リ I 数を 渡した 場合 
は、 アドレスを 渡して いる にもかかわらず、 その 閲 数の 中では 問 接演符 .7 •や アクセス 演符 
子 （->) を 使わなくても、 その 引数を 参照したり、 変史 できます。 っまり、 参照には 「アド 
レス 渡しに よる オーバーヘッドの 減少」 と 「ブロ グラムの 簡潔な 記述」 という 2 っの 利点が 
あると いえます。 ただし、 参照で あるか どうかは 閱 数の 走 在を 兄 なければ はっきり しないた 
め、 閲 数の 中で 侦 を変史 できる のか どうか はっきり しないと いう 欠点が あります。 侦を変 
史 する 丨げ能 性が ある 場合には、 できるだけ コメントで はっきり させて おくと よいでしょう。 

リスト A -7 » 照と ポインタを 使った 引数の •照 渡し 

struct loc { 
int x, y; 

} 



void plusone(loc& ref) // 参照 型を 引数に 取る 

{ 

ref .x++; 
ref .y++； 



void plusone(loc* ptr) // ポインタを 引数に 取る 

{ 

ptr->x++; 

ptr->y++; 



loc value; 

plusone (value) ; // 参照 型を 引数に 取る 関数 呼び出し 

plusone(ftvalue) ; // ポインタを 弓丨 数に 取る M 数 呼び出し 
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参照を 使った 関数の 返り 侦に閲 しても 同様な 利点が あるので すが、 さらにもう 1 つ 重要 
な 利点と して、 間数の 呼び出しを 代人 式の ノ r : 辺倘 として 利) 丨1 できる ことがあ げられ ます 0 
これは、 本書では 扱って いません が、 □演兑 子 や 0 演兑了 •の オーバーロードを 行う 場合 
に 簡潔な 表現を する ために 不要になります。 

リス 卜 A-8 参照に よる 関数の 返り 値 

loc& dist(loc& ref); // dist 間数の 宣言 

loc value 1, value2; // valuel, value2 を定典 

value2 = dist (valuel) ; 
dist (valuel) = value2; 



"間数の 返り 値に® 接 値を 代入 



0 C ++ の ツポ: ポインタ 変数 




本: 丨丨! 1 で 初めて C ++ •丨 に チヤ レンジし ている •说荇 の" は、 ポインタの 扱いに 苫 労して は 
いないで しょう か 。しかし、 心 rti! はいりません (> C++ ブロ グラマなら、 •淮 もが ポ イン 夕の 
ことで 頒を抱 えた ことがある ハズ です 3 抱 えた ことがない という 人は、 尺 I か、 はたまた 
棠は C ++ について ホン 卜は 押 解して いない かの どちら か、 という ほどの モノな のです そ 
こで、 Appendix B では、 •沾题 を この 雒閲に 絞り、 ポインタ について 解 •说 します。 

B .1 変数と メモリ 

〇+• t 語で 変数を 使い 始める には、 

CString s; 

int i; 

といっ たように 変数の 定義を 行わなければ なりません。 これは いうまで もありません が、 
それでは 変玫の 定義とは いったい fnj をぬ: 味す るので しょう？ 玫侦演 饤や ライブラリ 閲 数の 
呼び出しの ように、 何か処 坪が 行われる わけではありません が （ただし、 クラス 才 ブジェ 
ク 卜の 记 在では コンストラクタが 起# される） 、丨 ji . に 形式的に 必要と されて いる わけで もあ 
りません。 

変数とは 怡 報を 格納す るた めの 人れ 物です から、 格納す るた めの スペースが コン ピュー 
夕の メモリ 丨 ••に 必要です。 この スペースを 確保す る作衮 が 変数の 定 在に ほかな りません 
スペースを 確保して 初めて 変数に 惝 報を 格納 できるようになる ため、 変数を 使うた めには 
走 在が 必製 という わけです。 確保され る スペースの サイズは 変数の 叩に 依存し ますた と 
え ば、 LONG M 変数なら ば/！ バイト、 SHORT 沏 変数なら ば 2 バイトと いう 抖 合です。 ま 
た CString® や CWnd 他な どの クラス 才 ブジェク 卜を 定義した 場合には、 こうした クラス 
には たくさんの メンバ 変数が あり、 それらす ベての メンバ 変数の ために いっせ いにス ペー 
スが 確保され るた め、 数丨 •バイト、 数 西 バイ 卜と いった 規投で メモリが 確保され ます 
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ところで、 このと き メモリ 上の どこに スペースが 確保され るので しよう 。メモリには アド 
レスと 呼ばれる インデックスが 1 バイト 中 •位で ふられて います 。つまり、 変数の ために 確保 
された メモリ 上の スペースは、 その 先頒 アドレスを, 揭 ベれば 位 沢が わかります （図 B -1 ) 〇 
そして、 変数が 浏 り， 1 1 てられて いる アドレスを 調べる には、 & s や & i のように & 演兑 子を 
使います。 ただし、 こうして 得られた アドレス 侦 を数侦 として 衣 示しても、 あまり 意味は 
ありません。 変数の ために 必贤な メモリ スペースは 「1勋 的に 適切な 場所に 確保され るた め、 
ブロ グラマが 总識 する 必贤 はない からです。 たとえば、 変数 i が アドレス 0 x 0012 ff 7 c から 
続く 4 バイト （0 x 0012 ff 7 f まで） に 格納され ていたと しまし よう。 この場合、 たとえば、 

if (i == 0) ... 

のようにして、 変数 i を 参照 すれば、 アドレス 0 x 0012 ff 7 c に 格納され ている デ 一夕が 参照 
されます か' ブロ グラマに して みれば、 中. に 変数 i を アクセスした のであって、 アドレス 
0 x 0012 ff 7 c に 格納され ている 侦 を 参照した ことな ど 知っている 必要はありません。 



int i = 1 ; と SKi を定鼸 すると • 



メモリ 




変数 i の 個は 00x0012ff フ c からの 
OxOO 1 2ff7f までの メモリ 領域に 
格納され る 

このと き、 &i の 値は 0x0012ff7c 
となり、 （ & i + 1 ) の 値は 
0x001 2ff 80 となる 



図 B-1 変数と メモリ 

ただし、 アドレス 0 x 0012 ff 7 c のように M •体 的な アドレス 侦を 知っている 必要は なくと 
も、 アドレス 倘を 取り出す ことには, S 味が あります 。たとえば、 （&i + 1) という 式は、 &i 
の侦に 間 係な く、 変数 i が 格納され ている メモリ スペースの 次の アドレスを 表します。 も 
し 配列の ように 速 続した メモリ スペースに データが 格納され ている としたら、 変数 i のア 
ドレスを 基噃 にして、 相対的な インデックスを 指定して、 船 添 : に メモリの 丨人 Jff を アクセス 
する ことができる という わけです。 後述す るよう に、 この 他に も データが 格納され ている 
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アドレスを 扱う 利点は 多岐に わたります。 そこで、 C/C++ 言語には アドレスを 値に 持っ 

変数彻 が⑴盘 されて います。 そして、 この 変数喂 の 変数の ことこ そ、 钎 さんの 頭を悩ませ 
ている ポインタな のです。 



B .2 ポインタ、 基礎の 基礎 

なぜ ポインタの 扱いは 難 •しいと される ので しょうか 〇 现丨 丨丨の 】 つは、 ポインタの 侦が丨 |{ 
確に 想定され た範洲 になければ、 即丨 j； (因 究明の 難い、 誤勑 作が 起きる からです。 幣 数値の 
演 灯 ならば、 たとえば 座挖の 計 灯: こ問迩 いが あっても 、とっぴょうしもない ところに ウィ 
ン ドウが 表示され たりす るか もしれ ません が、 即 アプリケーションが 铒常 終了す る ことは 
ありま せんし、 問 题简 所の 兑、レ丨 をつ ける ことは 雖 しくはないでしょう。 しかし、 ポインタ 
の侦が 誤っ ている 場合は、 突 行す るた びに 結果が 饵 なったり、 問題 简 所とは まったく 閲逨 
のな さそうな コードで 與常# 作が 発觉 したり、 問題の ある ポインタ 拽 作を 行って からし ば 

らく 経たなければ 與常 動作が 発觉 しなかった りと、 わずかな ミスが やっかいな トラブルを 
引き起こします。 

そうした ポインタ 特イ I •の 問 题に 悩まされな いために も、 まずは ポインタを 扱う 作法の 故 
礎を しっ かり 抑えて おき ましょう 。ここでは、 ポインタ 変数の 走 在と、 ポインタに よるメ 
モリの 間接 参照に ついて 解説し ます。 

•ポインタの 定義 

ボ インタは int 彻や char 喂 などの 変数喂 とは 穴 •なり、 すべての 変数 彻が 持つ诚 性と 芩え 
る。 とかで きます。 つまり、 j nt 彻のボ インタ、 char 增 の ポインタ、 さらに cs tr j ng 耶 のボ 
インタな ど、 あらゆる 変数 耶 クラス 偁造 体に ついて、 ポインタが 徉ず丨 •: します int 沏 
への ポインタを 使っ て データを 参照す ると、 その ポインタが 指し示して いるア ドレスには 
int 咽の データが 格納され ている ものと して 処那 されます。 変数 喂 によって データの サイズ 
(sizeof 演灯了 •で 取得 可能） は 興な り、 また 興なる 変数 哦の データを ポインタで 参照して し 
まう と 本来とは 與 なる 内袢で 説み 出されて しまいます から、 ポインタを 走 在 するとき には 
参照 先の 変数 沏を指 走し なければ なりません。 いずれの 変数 ゆへの ポインタで あろう とも 
ポインタに 格納され るのは 常に アドレスで すが、 ポインタを 使って データを 参照す るた め 
には 変数 沏が 必要な のです。 

このため 、ポインタ 咽 変数を 记義 する には、 「変数 ゆ」 + 「ポインタを 衣す 記サ （ァス タリ 
スク、 *)」 の 形式で 記述し ます。 たとえば、 i nt 咽への ポインタ 変数 pi を定 在す るなら ば、 
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と 記述し ます。 M じように、 クラス CString への ポインタ ならば、 

CString* ps; 

のように 記述し ます。 通常の 変数 定義と w なり、 変数 嘲と 変数 名の 問に* を 指定す る こと 
で、 ポインタ 変数を 定義す る ことを 示して います 。こうして、 指定した 変数 取への ポ イン 
タ 変数が 定義され ます。 

このと き 走 在され るのは あくまでも ポインタ 変数で あり、 指定した 変数喂 の 変数が 逛在 
される わけでは ない ことに 注愆 してく ださい 。すなわち、 「int* pi」 としても、 int$! への 
ポインタを 格納す る メモリ スペースが 確保され る だけで、 int 沏の 数侦を 格納す るた めの メ 
モリス ペースは 確保され ません 。また、 「CString*ps」 としても、 CString 沏 への ポ イン 
夕 変数が 定義され る だけで、 CString クラスの コンストラクタは 起# されません し、 この 
時点では まだ CString クラスの メンバへ アクセス する こと もで きません 0 

つまり、 ポインタ 変数を 定義した あとには、 必ず 適切な アドレスを 代人して 初期化し な 
ければ、 ポ イン 夕 変数を 使って メモリ 丨 •.の デ 一夕を アクセス する ことは できない という こ 
とです。 

初期化せ ずに ポインタを 使って 読み 许 きする と、 何が 起こる のでしょう 〇 C/C ++ 言語 
では、 グローバル 変数を 记在 すると 初期 侦は 〇 に、 ローカル 変数を 定在 すると 初期 侦は米 
定 になります 。ポインタの 侦が 0 という ことは、 アドレス 0x 0 を 指し示す ことを 米し ま 
すが、 この アドレスは システム によって 保, 澳 されて いる メモリ 領域で あるた め、 読み,*! ••き 
を 行おうと すると、 アクセス 違 反と して ブロ グラムは W •常 終了して しまいます 。また、 侦 
が米定 のま まの ローカル ポインタ 変数を 使って 説み, 1 f きを 行う と、 グローバル 変数と M じ 
ように、 システムが 保,® している メモリ 領域を アクセスして 與常終 r する か、 まったく 予 
想の っかない メモリ 領域を アクセス する ことになります。 前行は 铒常 終/する だけ まだ ま 
しです。 後名 •の坳 介は 柯が 起こる か户 想が つきません 。読み出した ときには、 プログラム 
を 実行す るた びに 興なる、 無意味な 侦が 取り出され、 ブロ グラム 自体は 何事 もなかった か 
のように 処那が 続けられて しまう や もしれ ません 。また、 初期化され ていない ポインタが 
指す メモリ 領域 にれ き 込みを 行えば、 運悪く メモリ 丨 •.の データを 破壊して しまう かもしれ 
ません。 こうした バグは もっとも 発 U の 難しい 類の バグの 1 つに 数えられる ほど やっかい 
な ものです 。したがって、 初期化し ていない ポインタを 使って、 メモリを 参照して は 絶対 
にいけ ません。 

では、 ポインタを 初期化す るには どう すれば よいので しょうか？ ここで 出て くるの が、 
さきほど 紹介した & 演兑 子に よる、 変数の アドレスの 取得です。 たとえば、 




B.2 ポインタ、 基礎の 基礎 



として、 intM への ポインタ pi と int ® 変数 i が あった とすると、 
pi = & i ; 

とする ことで pi に、 i の アドレスが 設定され ます （図 B -2)0 これは もっとも 簡単な ポ イン 
夕の 初期化の 力 •法の 1 つです 。このほか にも、 ポインタを 初期化す る 力 •法は いくつか あり 
ますが’、 それらに ついては また 後 ほど 説明を します 



int i = 1 ; 
int* pi; 

Pi = fii : と 変数 i と pi を 定義す ると … 



メモ II 




Pi の® は 変数 i の ffi が 格納され てい 
る メモリ 領域の 先頭 アドレス であ 
る （&i) 

すなわち、 pi は i の偭を 指し示す も 
の （pointer ) である 



図 B-2 ポインタと 変数の 間 係 



潘ポ インタに よる メモリの 間接 参照 

ポインタを 初期化す るには いくっかの 方法が あるので、 ひとまず ここでは 敗いて おい て、 
何ら かの]^ 段です でに 初期化が 行われて いる ポインタを 使った メモリ アクセスに 話題を 移 
しま しょろ 0 

次のように ポインタ P が 定義され、 何ら かの 侦 （アドレス） が P に 代入され ている 場合、 

int* p; 
p = …； 

p に 格納され ている のは アドレス 侦 ですから、 
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int i = p; // エラー！！ 
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のように 単に p の 値を 参照した だけでは、 ポインタ P が 指し示す メモリへ アクセス できる 
わけではありません 。ポインタが 指し示す メモリへ アクセスす るた めには、 ポインタ 名の 
前に アスタリスクを 指定し ます。 ポインタ 変数を 定在 するとき にも アスタリスクを 使い ま 
したが、 意味 的には まったく 黄なります 。定義の 時の アスタリスクは、 ポインタ 変数の 定 
在を-衣す もので したが、 ここでの アスタリスクは、 ポインタ 変数を 通して 問 接 的に メモリ 
の 内容を 参照す る ことを 衣します。 

たとえば、 ポインタを 使って メモリに アクセス すると、 次のように なります。 ここでは、 
int 喂 変数 i が 格納され ている アドレスを &丨 によって 取り出し、 これを 代入す る ことで ポ 
インタ p を 初期化し ています 。したがって、 以後* P を 参照 すれば 変数 丨の侦 が 参照され、 
*p の 値を 書き換えれば 変数 i の侦も 杏き 変わります 〇 また、 変数 丨 の内咨 を忾き 換えれば、 
*p で 参照され る侦も 変わります。 

int i = 1; 

int * p = & i ； / •変数 i が 格納され ている アドレスを ポインタ p へ 代入 •/ 

printf (" •乂 d ¥ n ", * p ); /** p によって、 変数 丨 の 内容が 参照され るた め、“ 1" が 表示され る •/ 
i = 2; 

printfC 7 # dYn "， * p ); / •変数 i の偭が 変更され たため、“ 2" が 表示され る*/ 

*p = 3; /• によって 変数 i の 内容が 3 に 害き 変わる 

ポインタ p に 格納され ている アドレス 値に 影響は ない*/ 
printf ( M # /. d ¥ n M , i ) ; / •前行に よって 変数 i の 僅が 変更され たため、“ 3" が 表示され る*/ 

このように ポインタを 使う と、 メモリ 上の データを 問 接 的に 参照で きる ようになります 
が、 アスタリスクの 有無に よって 変数彻 が 変化す る ことに 注： S してく ださい 。たとえば、 
前述の 例なら ば、 次のようになります 0 



参照 方式 


変数 型 


P 


int* 型 


*p 


int 型 



ポインタ 変数は アドレス 侦を 格納す る 変数 彻で すが、 アスタリスクを 付ける と、 参照 先 
の 変数 M に 変化し ます。 

次に クラス や 構造体への ポインタの 使い方で すが、 錐 本 的には int 彻 などへの ポインタ 
と 同じです 。アスタリスクを 前！ S して 参照 すれば、 参照 先の クラス 才 ブジェク 卜 や 構造体 
として 利 川で きます。 



CStnng * s ; 
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参照 方式 1 


変数 型 


S 


CString •型 


*s 


CString 型 



ポインタを 介して、 クラス や 構造体の オブジェクトの メンバへ アクセスす るには、 次の 

2 通りの どちら かの 方法を 使います。 一般的には 、前者の-〉 演算子を 使った 形式が 使われ 
ます。 



s->GetLength() 

(*s) .GetLengthO 

これまでの アスタリスクを 使った 形式に のっとれば、 後荇の 形式と なります が、 この 坳 
合* S を 州む ように 括弧が 必要になります 。これは、 アスタリスクよりも メンバ 参照 ドット 
(•) の 方が 後先 順位が 高いた め、 「*s.GetLeng： th( )J と 記述す ると、 コンパイラが これを 「* 
(s.GetLength())」 と 解釈して しまうた めです。 ここでは 変数 s はボ イン 夕です から、 敗 
接 メンバ 参照 ドッ 卜を 使って メンバに アクセス する ことは できない ため、 エラーに なって 
しまいます 。しかし、 いちいち カッコで くくる のは わずらわしい ので、— 般 的には 前者の 
-> 演灯了 •が 使われる のです。 

B .3 ポインタ 型 変数の メリ ッ 卜と 初期 イ匕 

ボ インタを 使う 理丨 丨丨 あるいは メリットとは なんでしょう。 

消極的な 理山 としては、 MFC で 提供され ている 閲 数で ポインタが 使われて い るから、 と 
いう ものが あります 。たとえば、 CView::OnDraw メンバ 閲 数の 引数には CDC クラス 才ブ 
ジェク 卜への ポインタが 使われて いますし、 AfxMessageB〇x 間数では 表示す る メッセ 一 
ジ のために ポインタを 引数に 使います。 

もちろん、 ライブラリで ポインタが 使われて いる ことには 明確な 理丨 おがあります。 おお 
ざっ ばに 表現 すれば、 ポインタを 使う ことで 処理 速度が 句 上し、 コードが 短く スマートに 
なる 効果が 期待で きる からです。 また、 必要な ときに 必要な だけ メモリを 確保す る、 動的 
な メモリ 膂理が 可能になる 点 も ポインタを 利用す る 大きな 理丨 丨丨の i つ です。 

それでは、 具体的に ポインタを 利用す る メリットを ケース 別に 解説す る ことにし ま しょ 
う。 ここで ケース 分けの ボ イン 卜になる のが、 前節からの 持ち越し になって いる ポインタ 
の 初期化 方法です。 ポインタを 利用す る 前には 初期化が 欠かせな いのは 前述した とおりで 
すが、 この 初期化 方法にから めて、 ポインタを 使う メリットを 解説し ます 
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•配列 

C + +ii •語の rtd 列と ポインタは 兄弟の ような ものです。 C ++ 言語では 厳しい 彻 チェックが 
行われる ため、 異なる 型 間での 代入 や 比較は 不正な 処理と されたり、 警告を 受けたり しま 
すか' M じ喂の ポインタと 妃 列なら ば、 ポインタ 変数へ 妃 列を そのまま 代人で きます 。そ 
して、 これが ポインタを 初期化す る 力 •法の 1 つと なります。 

たとえば、 char 5? の 配列 変数 a と、 char * 彻の ポインタ 変数 b が あった とき、 次の 処 押 
によって、 ポインタ b は 配列 a によって 初期化され ます。 もっと JI 体 的に 衣 現す ると、 妃 
列 a を 定義す る ことによって 10 バイトの メモリが 確保され る わけです が、 この 10 バイ 卜 
の 先頭 アドレスが ポインタ b に 代人され ます （図 B -3>〇 

char a [10]; 

char* b = a; / •配列 変数を 配列 要素への アクセスに 使わなければ 、ポインタと 

同じ アドレス 値を 持つ 定数と して 扱われる 



char a [10] ; 

char* b = a : と 配列 a と ポインタ b を定鼸 すると… 



メモ _J 




b の® は 配列 a の 先頭 要 索 a [0] が 格 
納 されて いる メモリ 領域の 先頭 ァ 
ドレスで ある 

このと き、 配列 a は char 型の 配列 
なので、 b +1 は 0 x 0014778 d と 
なり （sizeof ( char ) = 1) 、 

* ( b + 1 ) は a [ 1 ] を 指す ことになる 



図 B -3 配列と ポインタ 

したがって、 次の 左右の 式は まったく H じ侦を 返す ことになります。 



a[0] *b 
a[ l] *(b + 1) 
a [2] *(b + 2) 
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ただし、 逆に 配列 変数 a に対して ポインタ b の侦を 代入す る ことは できません 。ポ イン 
夕は 変数です から 値を 変史 できます が、 配列 変数は 妃 列の 要桌が 変数であって、 fill 列 その 
もの、 つまり 配列の ために 確保され ている メモリ 丨 •.の 位 的は 定数に すぎない からです。 

さて、 こうして ポインタを 利丨 |j して 配列を 扱える ことを 述べました が、 配列を あらため 
て ポインタで アクセス する 理 (tl はなんで しょう。 

まず 配列を 定義す ると、 间定 長の メモリ スペースを 手 系に 確保で きます。 すでに 述べた 
ように、 ポインタを 定義す る だけでは 、データを 格納す るた めの スペースを 確保で きませ 
ん から、 まずは 配列を 定義し ます。 

次に rtil 列の 贤桌に アクセス するとき です が、 ここでは 例と して、 丨 数 lookup を 定義し 
て、 この 関数の 中で 妃 列に アクセス する 処现を 考えて みましょう 0 



char a [10] 
int result ; 

result = lookup (a, 3); 



int lookup (char array [], int index) 

{ 

/ •何 か 配列に 対して 処理を して、 戻り 值を 返す 

} 

lookups 数の 走 在を U ると わかる ように、 rtd 列 変数に 加えて、 要ぶ を 指定す るた めの イ 
ンデッ クスを int 沏の 変数で 受け取って います 0 
次に ポインタを 使った M 様な 処邱を U てみ ましょう。 

char a [10] ; 
char* p = a; 
int result; 

result = lookup (p + 2); 
int lookup (char* p) 

/， 上述の lookup 間数と 同じ*/ 

} 

どうで しょう か 。今度は ポインタ 変数を 1 つ 渡す だけで 済んで います。 l 〇() k Up 間数の 内 
部では 配列 a に アクセス している ことは わかりません か' とくに 問題はありません 。つま 
り、 配列の 要素を 指定す るた めに、 rti! 列と して アクセスす るには 配列 変数と インデックス 
の 2 っの 倘が 必要です が、 ポインタ ならば、 ポインタ 変数 1 つで 済む という ことです 。実 
にさ さいな ことです が、 リ丨 数に rki 列の 要桌を 4 つも 5 つも 指定す る 問 数なら ば、 よりその 
差は 際 だってき ますし、 戻り 値と して 配列の 要素を 返したい ときには、 丨 つの 変数で 表現 
できる 点は 兄 逃せません。 
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♦文字列と ポインタ 

C++ 言語では、 次のようにして、 文字列で char 喂 配 列を 初期化で きます。 
char str[] = "Hello Visual C++ World"; 

つまり、 文字列の デ ー夕彻 は char mrtil 列で ある ことを 总 味して います。 そして、 前節で 
述べた ように、 char 喂 fli! 列と char 喂 ポインタは |uj じ データ 喂 として 扱う ことができ るの 
で、 次のようにして、 char 喂 ポインタを 文ネ 列で 初期化す る こと もで きます。 

char* str = "Hello Visual C++ World": 



籲& 演算子 

すでに 解説した ように、 & 演兑イ •を 使えば、 変数が 格納され ている アドレスを 取り出す 
ことができます 。つまり、 ポインタ による メモリの 問 接 参照を 行う* 演 W ， •のちよう ど 逆の 
働きを する わけです 。このため、 次のようにして、 & 演 灯， •を 使った ポインタの 初期化が 
"f 能です。 

char a; 

char* b = &a; / •ポインタ b を 変数 a が 格納され た アドレスで 初期化 •/ 

もっとも 、外 :、 1 1 にこのと おりの コードを, 丨で 述 しても .a 味はありません。 これ だけでは、 
char 沏 変数 a を 使おう が、 ポ イン 夕 変数 b を 使おう が、 結 米は まったく M じだから です。 
この & 演 t): 子に よる ポインタの 初期化は 、主に 閲数呼 び 出し 時に 使います。 

例と して 次の コードを 尔 します 0 



CRect r(0, 0, 200, 200); 
pWnd->MoveWindow(&r) ; 

CWnd::MoveWindow メンバ 閲 数は、 次のように 引数に CRect クラスへの ポインタを 受 
け 取る ように 足 義 されて います。 

void CWnd: : MoveWindow (CRect* pr) 

したがって、 上述した CWnd::MoveWindow メンバ 問 数の 呼び出し 時には、 
pr = &r; 

に 相当す る 処理が 行われる という わけです。 こうして、 ポインタ 変数 pr の 初期化が 関数 呼 
び 出しと 丨"1 時に 行われます。 

ところで 、閲数 呼び出しに なぜ ポインタを 使う のでしょう 0 これには 3 つの现 丨丨丨 が あり 
ます。 

1 つ 目は、 IKI 数 呼び出しを 高速に 行うた めです。 C+ + 言語では 通常、 関数を 呼び出す と 
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き、 リ丨 数の コピーが 作成され ます 。たとえば、 次のように 定戎 された p rocess \Vindow 関 
数が あつたと しまし よう 。この 問 数では、 CWnd オブジェクトを ポインタで はなく、 通常 
の CWnd オブジェクト として 受け取ります。 



void ProcessWindow(CWnd w) 



この 関数を 呼び出す と、 まず C\Vnd 才 ブジェク 卜で ある 変数 vv が ローカル 変数と して 
新たに 作成され、 その後 呼び出し 叫に リ丨 数と して 指 足した CWml オブジェクトの メンバ 
変数の 侦 がすべ て 変数 vv に コピー される ことにな ります。 したがって、 閲数呼 び 出しの た 
びに、 CWnd クラスの コンストラクタが 吵 び 出され、 数丨 •バイトの メンバ 変数が コビー さ 
れ ます 。これに 対して、 次のように 定 在され た ProcessWindowP 関数なら ば、 わずかに 
sizeof (CWnd*) = 4 バイト （Pentium ブロ セ ッサの 場合） のボ インタ 変数が コビーされ 
る だけで 関数 呼び出しが 实 行され ます。 



void ProcessWindowP(CWnd* w) 

膨大な M 数が 繰り返される 閲数 呼び出しでの コビー 処观時 問は 無 祝で きる ものでは あり 
ません。 リ丨 数が int 咽 変数で あったり、 char 增 変数であった りした 場 介には、 コビ一 され 
る データ サイズは ポインタと ほとんど 変わらな いため、 ポインタで 渡す 必然 竹は ありませ 
んが 、サイズの 人き な クラス 才 ブジェク 卜 や惝造 体の 坳介 には、 ポインタで 渡す と 問 数 呼 
び 出しが A 速 化される のです。 

もう 1 つの 利 III も、 この リ丨 数の コビーに 閲迚 します。 閧 数の 引数へ 「コビー」 によって 
侦が 渡る という ことは、 閲数呼 び 出しに 指定した 変数と、 受け取った 側の 変数は 叫 じ侦を 
持つ、 別の 変数と いう ことです 0 たとえば 次のように 前述した p rocessW i ndow 関数を 呼 
び 出した としまし ょう。 このと き、 変数 wnd と ProcessVVindow にリ丨 数と して 渡された w 
は、 内 料 こそ 丨 Hj •です が、 2 つの 独、 •/ •した 変数で、 変数 w は ProcessWindow 関数の 処理 
が 終了す ると Ml ほに 削除され てし まいます。 

CWnd wnd; 

ProcessWindow^wnd) ; 

ここで 問題な のは、 ポインタを 使わずに 閲 数へ 侦を渡 したと きには、 呼び出しに 指定し 
た 変数は M も 探 作で きないと いう ことです この 例なら ば、 p rocess Wi n d〇wlW 数 内部の 
変数 w を 操作しても、 変数 wn d には 何の 釤郛 もありません 。問 数 内部での 処 ■結; u を 残 
したければ、 り 侦 として 侦を 返す しかありません が、 それでは 1 つの 値し か 返せません。 

しかし、 次のように、 ポインタ バージ ヨンで ある p rocess \ V ind〇wP 間数を 呼び出し たと 
きには、 閲 数 内部での 変数 w への 操作は そのまま 変数 wn d への 操作と なります。 ポ イン 
夕を 使う ことによって、 あたかも 問 数丨丨 f び 出し 時の リ丨数 コビーが •行われなかった かの よう 
に、 呼び出し 側で 记 在され た 変数を 操作 できるようになる のです 
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CWnd wnd; 

ProcessWindowP(&wnd) ; 

さらにもう 1 つ、 C ++ に 特有の スライ シング 問題と 呼ばれる 問題 もあります。 上に 示し 
た ProcessWindow(CWncn に CWnd クラスから 派生した クラスの オブジェクト （たとえ 
ば C View ) を 渡した とすると どうなる でしょう か？ ProcessWindow ( C Wnd ) の 引数の 型. 
は CWnd 彻 ですから 、間数の 呼び出し 時に CWnd クラスの オブジェクトが 作成され、 そ 
こに CView クラスの オブジェクト のうち、 CWnd クラスに 相当す る 部分 だけが コピー さ 
れ ます。 そして、 他の 部分は 切り落と （スライス） されて しまう のです 0 

このと き、 ProcessWindowlii] 数の なかで、 リ丨 数の 火 際の 彻に 依存した 処理 （仮想 メンバ 
W 数の 呼び出し など） が 行われて いた 場 介、 本来は CView クラスに 依# した 処理が 行われ 
る ことを 总丨 句して、 ブロ グラマが ProcessWindow 問 数に CView クラスの オブジェクトを 
i 度しても、 渡される のは あくまで CWnd クラスに 切り落とされた オブジェクトで すから、 
CWnd クラスに 対応した 処现が 行われて しまう のです。 

こうした ことを 避ける ために も閲 数の リ丨 数を ポインタで 渡す ことが 取 要に なって きます。 

鲁 new 演算子 

(類の ポインタ 初期化 ノ / 法は、 すべてす でに 確保され た 変数の アドレスを 取捋し 
て、 ポインタに 代人して いました 。つまり、 すでに 存在す る 変数の 別名と して ポインタを 
利⑴ したわけ です。 対して、 new 演 による ポインタの 初期化は 、新規に メモリを 確保 
して、 その メモリの 先頭 アドレスを ポインタに 代人す る 点で これまでとは 光なります 。つ 
まり、 new 演灯 子を 呼び m した 丨« 後では、 その 侦を 代人した ポインタ 以外には、 確保した 
メモリ 領域に アクセス する 手段は ない という ことです。 

Vf 頭で、 変数の 定 在とは データを 格納す るた めの メモリ スペースを 確保す る こと だと 述 
ベました 。つまり、 new 演 t): 子は 変数 定義の もう 1 つの 形と もい える でしょう 。ただし、 
明/ 丨; •的に delete 演兑了 •によって メモリ 領域を 解放す る ことができる、 そして 明示的に 解放 
しない 限りは メモリ 領域は 維持され 続ける 点が 大きく 递 います。 

変数には グローバル 変数と ローカル 変数が あります 。グローバル 変数は プログラムの 起 
動と m 時に メモリ 領域が 確保され、 ブロ グラムが 終 r する まで 維持され ます。 ローカル 変 
数は、 関数 呼び出しと 同時に 確保され、 閲 数の 実行が 終 r すると 自動的に 削除され ます 0 
いずれに しろ、 変数が# 在して いる 期 問を ブロ グラマが 制御す る ことは できません。 また、 
確保す る メモリ 領域の サイズ （たとえば 配列の 要ぶ 数） は、 固定 m でなければ なりません 0 
すなわち、 new 演 J): 子を 使わない としたら、 プログラムが 扱える データ サイズを コンパイ 
ル 時に 決 走し なければ ならない ため、 無总 味に 膨大な メモリ 領域を 確保して 余らせる か、 
兄り なくなって 「これ 以上 大きな データは 扱えません」 とお 断わりの メッセージを 表示す る 
はめになる という ことです。 
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new 演兑 子を 使えば、 明らかに メモリ 符理の 白 ilj 度は 上がります 。必要に応じて メモリ 
を 確保し、 必要 なくなれば 解放して、 次に new 液 筇子が 呼び出された ときに 洱 利〗 |j でき ま 
す。 したがって、 常に 必要 敁小 限の メモリし か 使わずに 済みます 。また、 コンパイル 時に 
は データ サイズを 決めて おく 必要は ない ので、 どんなに 大きな デ 一夕で あっても 対処 町 能 
です 0 グローバル 変数 や ローカル 変数の ように、 コンパイル 時に 確保され る メモリ 領域が 
決 走され る メモリ 竹 押 •は 「筋 的」 と 衣 现 され、 new 演兑イ •のように、 実行時に 使用す るメ 
モリ 領域が 決定され る メモリ 符理は 「動的」 と 表現され ます。 

このように 便利な# 的な メモリ fT •押 •を 利 叩す るた めに、 ポインタは 欠かせない 道具と な 
ります。 

なお、 間数の W り侦 として、 閲数 内の ローカル 変数への ポインタを 返す ことが ないよう 
に してく ださい 〇 .1 •.述 したよう に、 問 数 内の ローカル 変数は、 関数の 終 广 とともに 削 
除され ますから 、間数の 戻り 俯と して 返した ポインタは、 間数の 終了後には すでに 無盘味 
な メモリ 領域を 指す ことに なって しまいます。 
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w： 後に、 ポインタに まつわる 細かな 話題を ビック アップして まとめます。 

• NULLtK インタ 

初期化され ていない ポインタ や、 特別な 状態に ある ポインタを 衣 現す るた めの 侦 として、 
NULL 侦が定 在され ています。 たとえば、 次のようにして 使います。 

char* p = NULL; 

if (p == NULL) 
p = new char [10]; 

Visual C++ では、 NULL f|/ (は 「（void*)0」 として 定義され ています。 アドレス 〇x〇 はシ 
ス テムに よっ て 保護され ている ので、 アクセス すると システム によって ブロ グラムは 強制 
終 广 されます 。こうした ことが 起こる ブロ グラムには バグが ある わけです が、 ブロ グラム 
が 強制 終 丫 されれば、 どこで 問題が 発生した のかを 突き止め やすく、 デバッグ も 比較的 楽 
になります 。もし ポインタの 値が 不正な 値だった 場合、 あたかも 正常に メモリを アクセス 
した かの ように プログラムが 続行され てし まう かもしれ ません。 そうなる と デバッグは 非 
に 困難になります。 

したがっ て、 ポインタが まだ 初期化され ていない とき や、 メモリを 解放して ポインタが 
参照して いる メモリ 領域が 使え なくなった ときには 、ポインタの 値を NULL にしておく 
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と、 面倒な トラブルを 1〇1 避す る ことができます。 

籲 ポインタの 演算 

ポインタに 格納され る データは アドレス という 数侦 ではあります が、 特殊な 数値で ある 
ため、 ポインタ に対して 行える 演兑は 加減ね: だけに 制限され ています 。ポインタの 値を 垧 
減 させて、 迚続 した メモリ 領域を アクセス する ことは あっても 、ポインタの 侦を 2 倍した 
アドレスを アクセス するな どと いう ことは、 現実と して ありえません 。そこで、 C++ 言語 
では、 敁 初から 乗除 tr •はでき ないよう になって いるので す。 

ところで、 ポインタ に対する 加減 灯 には、 M 常の 数侦 への 演 灯と M じように、 +、-、 ++、 
— が 利用で きます が、 その# 作は 少し 特殊です。 

int * p = く 初期値〉； 
p = p + 1; 

以丨 ••の コードを 戈 行した ときに、 + 演 灯， •で增 加す る ポインタ p の侦は 「1」 では ありま 
せん 。止 解は 「sizeof(int) =4」 です （Pentium プロセッサの 場合） 。すなわち、 ポインタ 
変数が 指し ボ している 変数 咽の サイズ だけ 增加 する のです。 ちえて みれば、 非常に 介 ■.的 
な イ1: 様で ある ことが わかる でしよう 。たとえば、 列を im* 沏 ポインタで アクセスし 
ている としまし よう 。配列の 要 本数が 10 であれば、 s i zeo f(int> * 10 = 40 バイトの 領域 
が 確保され、 sizeof(int) =4 バイトず つ 隙間な く 各 要 灰が 並べられ ている わけです。 これ 
をボ イン 夕で 順に アクセスす るた めには、 ポインタの 侦を 4 バイトず つず らして いかな け 
れ ばな りません 。このため 、ポインタ に対する + 演 灯/ •は int 沏 変数 や char 地変 数と 递っ 
て、 特殊な 動作を する ようになって いるので す。 

もちろん、- 演灯子 や-- 演 灯 子で 減少す る ポインタ 侦 、それに ++ 演 t): 子 も 同様です。 ポ 
インタに 対する 演兑 は、 中. 位は バイトで はなく、 変数 喂の サイズを 1 中. 位と する 特殊な 中. 
W： となります。 

もう 1 つ、 ++、-- 演灯了 •に IW 速す る 注;® 点と しては、 次の 表現が あります。 



メモリ 領域を 順に 走 作す る 場合によく； |j いられる 衣 現です が、 この ++ 演兑 子で 增加 する 
のは ポインタ 変数 p の アドレス 侦 であって、* p で アクセス される メモリの 内 料では ありま 
せん。 これは* 演算子 （間接 演算子） よりも ++ 演算子の 方が 優先順位が 高いた めです。 つ 
まり、 

*(p+ + ) 

と 解釈され ます。 もし メモリの 内容を 増加 させた ければ、 



(*P)++ 
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としなければ なりません。 

籲 typedef された ポインタ 型 

Visual C+ + の 開発 環境では、 たくさんの クラスが 走 在され ています が、 同じように 
typedef 指定， •で定 在され た彻が 数多くむ: 介: します。 そして、 これらの 中には、 ポインタ 
を なむ 喂も 多く 穴 まれて います。 たとえば、 LPCTSTR 彻は 次のように 定義され ています。 



typedef const char far* LPCTSTR; 



このように 沏 の定在 部に アスタリスクが 含まれて いるた め、 

LPCTSTR p; 

のように、 アスタリスクを 含まずに 変数を 定義しても、 この 変数 p は ポインタと なります。 
このため 侃？ iL する かもしれ ません が、 ポインタ 彻 として 定 在され ている® は、 必ず P また 
は LP で 始まる 名前が 付けられ ている こと さえ 党え ておけ ば、 問題はありません 0 

この 前沢詞 的に 使われて いる P はいう まで もな く Pointer の P です 。そして LP は Long 
Pointer の LP です。 なぜ P と LP に 分かれて いるの か、 そして Long Pointer とは 何 か、 
という ことは 现 がでは 父 にす る必贤 はありません 〇 Windows 3.1 以前の Windows シス テ 
ム でのみ 味の ある 違いで あり、 Windows 95 以降 Windows NT では、 P と LP は M じ 
と 考えて 弟し 支えありません。 
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本懲の 第 3 部 以降で 解説した ように、 ドキュメント-ビュー •アーキテクチャは MFC の 
根 斡を 成す 仆糾 みです。 ドキュメント クラスと ビュー クラスを 使わずに は灾 現の 雖 しい、 さ 
まざ まな 機能 （データファイルの 人出 ノ j 、 印刷な ど） を 提供して くれる ため、 もはや ドキュ 
メン 卜-ビュー •アーキテクチャ なしには Wi n d 〇 ws アプリケーションを 開発で きな くな っ 
ている かもしれ ません。 

しかし、？ ft 3 部より 前 では 実 ft 的には ドキュメント-ビュー •アーキテクチャを 使わずに 
サンプル ブロ グラムを 作成して いた ことから も わかる ように、 MFC に とって ドキ ュメン 
ト- ビ ュー •アーキテクチャは 必拟の 存在ではありません 。 とくに データファイルの 保存 
と 読み込みを 行う 必要の ない アブリ ケー シ ョンでは、 むしろ 屯 荷に さえ 感じられる かもし 
れ ません 。また、 ビューが 1 っ だけで あれば （ほとんどの アプリケーションは 1 つで 十分 
でしよう）、 ドキュメント クラスと ビュー クラスに わかれて いるのは 手 問が かかる だけで、 
メリットは それほど 多くはありません （拡張 性を 考えれば メリットは あります が )〇 
つまり、 ドキュメント 一 ビュー •アーキテクチャは 尚 機能な サービスを 提供す る ものの、 
作成す る アブリ ケー シ ョンに 適して いなければ、 策の 持ち腐れ どころ か、 開発の 足を ひっ 
ばる ことにな りかね ない という ことです。 

Visual C + + 5.0 では、 AppWizard で ダイアログべ一 スの アプリケーション タイプを 
指) ii すれば、 ドキュメント 一 ビュー •アーキテクチャを 使わない MFC アプリケーション 
を 作成で きました が、 ダイアログ ベースで なければ ならない 戍 に小満 が 残る ものでした。 
AppWizard を 一切 使わずに 1 から コー デ ィングを 始めれば ダイアログ ベースで なく、 幸 
た ドキュメント 一 ビュー •アーキテクチャを 使わない アプリケーションを 作成す る ことは で 
きました が、 難易度が あまりに 高い という 問題が あります。 さらに Cl assW i zard のよ うな 
周辺 ツールを 活 州す るには、 メッセージ マップの ように 本来の 開発 作業とは 閲 係ない 部分 
まで 手 作業で 作らなければ ならず、 手 問が かかって しまいました。 
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しかし、 Visual C + + 6.0 になって、 こうした ジレンマは 解消され ました 。 AppWizard 
が拡张 され、 SDI や MDI アブリ ケー ショ ン タイプで も、 ドキュメント-ビュー •ア ーキ テク 
チャを 使わない スケルトンを 生 •成で きる ようになった のです。 ドキュメント クラス も ビュー 
クラス も 使わない のです から、 数々 の 制約は あります が、 スケルトンは すっきりして 兄 通 
しのよ いものになります し、 M 常 どおり ClassWizard を 利用して メッセージ ハンドラを 作 
成す る こと もで きます 。 Visual C + + は いっそう 幅広い スタイルの アプリケーション 作成 
に 利〗 I 丨 できる 体制が 整ったと いえる でしょう。 

C .1 ドキ ュメ ン卜ー ビュー •アーキテクチャを 使わない 

MFC アプリケーションの 作り方 

それでは、 ドキュメント-ビュー •アーキテクチャを 使わずに MFC アプリケーションを 
丨!9 発する と、 どのような 制約が あるので しょうか 。これを 知る ためには、 何は ともあれ、 
AppWizard を起勋 して、 この 新しい スタイルの スケルトンを 生成して みる ことです。 こ 
こでは 本格的な アプリケーション 問 発までは 立ち入りません が、 これまで どおり、 操作 手 
順を 追う 形で 解説して いくこと にします。 

いつもの ように、 メニューから [ファイル] 一 [新規 作成] を灾 行して、 新規 ブロ ジヱク 
卜を 作成して ください 。[新規 作成] ダイアログ ボックスでは 「 MFC AppWizard ( EXE ) 」 
を 選択し、 [プロジェクト 名] に 「 NoDocView 」 と 人力して ください。 

ここで [ OK ] ボタンを クリック すると 6 ステップ からなる AppWizard による スケル ト 
ンの カスタマイズ 設记が 始まる わけです が、 ステップ 1 にある [ドキュメント/ビューアー 
キ テク チャの サポート] の チェック をはず すと、 ドキュメント-ビュー •アーキテクチャを 
使わない スケルトン コードが 生 •成される ようになります。 




書 定 < i ) 



|BTtt ( APPWZJPNOU ) 



<识>驳 | ; 欠へ < M » | »7< E > I 



図 C -1 ドキ ュメ ン卜 / ビュー アーキテクチャの サボー 卜の チェックを はずす 





C .1 ドキ ユメ ン卜ー ビュー •アーキテクチャを 使わない MFC アプリケーションの 作り方 



ここでは シンプルに 話を 進める ために、 [作成す る アプリケーションの 種類] で [ SDI ] を 
選択して ください 。これ 以降は すべて デフォルトの まま 最後まで AppWizard を 進めます 0 

[次へ] ボタンを クリック すると 残り 5 ステップが 続きます が、 [ドキュメント/ビュー 
アーキテクチャの サポート] の チェックを 外した ことによって、 いくつかの 選択 瑣 H が グレ 
イ になり、 選択で きなくなります 。これが ドキュメント 一 ビュー •アーキテクチャを 使わな 
い 代 俗 という わけです。 これを 見て いくと、 ある 程度 使った 場合との 違いが はっきりして 
きます。 

まず ステップ 2 の データベース サポートを 兄る と、 データベース ビューを 使う 瑣 目が 選 
択 できな くな ってい ます。 データベースは 本 作の 範 開を 超える ので 扱って いません が、 デ 一 
夕 ベース ビューは 名前のと おり、 ビュー クラスの 派生 クラスを 利用す る サービスです 。し 
たがっ て、 これは 利用で きません 。なお、 データベース ビューに 限らず、 CView クラスを 
穴め て、 CScrollView クラス や CFormView クラスな ど、 CView クラスの 派生 クラスは 
一切 利〗 H できません。 

次に ステップ 3 の 複合 ドキュメント サポートを 見る と、 複合 ドキュメントの サービスは 
いっ さい 使えない ことが わかります 。複合 ドキュメントが 何 かは ともかく、 こちらは ドキュ 
メン トクラスを 雄 本に した サービス であるた め、 やはり 利用で きません。 

この あとの ステップでは、 ビュー クラスで 提供され ている 印刷 サービスが 使えな くな っ 
ている ことと、 Windows エクスプローラ スタイルが 選択で き なくなって いる ことが わかり 
ます。 

以上の ように、 ドキュメント クラスと ビュー クラスの どちら かに 依存して いる サービス 
はまった く 使えません。 

逆に、 メインフレーム ウインドウで 符理 される ツール バー や ステータス バーに ついては 
通常 どおり 利用で きる ので、 これらの サービスが 欠かせない 場合で も 問題には なりません。 
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C .2 作成され る クラス 



AppWizard の W •後になる ステップ 6 を兑れ ば、 ドキュメント クラス も ビュー クラス も 
ない ことが はっきりと わかります。 
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図 C -2 ステップ 6 : AppWizard で 作成され る 新規 アプリケーション クラス 



AppWizard によって 作成され るのは、 表 C-1 に 示す たった 3 つの クラス だけです。 ま 
た、 これらの 基底 クラスは 変史 する ことは できません。 



CNoDocViewApp 


CWin App クラスの 派生 クラス 


CMainFrame 


CFrameWnd クラスの 派生 クラス 


CChildView 


CWnd クラスの 派生 クラス 



表 C -1 作成され る クラス 



ここで 注总 して ほしいのは、 CChild View クラスの 基底 クラスは C View クラスで はな 
く、 CWnd クラスで あると いう ことです。 名前 だけ 兑 ると 勘迩 いしそう です が、 CWnd ク 
ラスと いう、 すべての ウィンドウ 系 クラスの 基底 クラスと なって いる、 非常に プリ ミ ティ 
ブな クラスです 。しかし、 View の 付く 名前を 持つ だけあって、 CChildView クラスの 用途 
は ビュー クラスに よく 似て います。 図 C-3 に 示す ように、 CMainFrame クラスが 管理す 
る メインフレーム ウィンドウが 外側に あり、 その クライアント 領域を 埋め 尽くす ように、 
CChildView クラスが 管理す る ウィンドウが 納まります。 これは ドキュメント 一 ビュー. 
アーキテクチャを 使った ときの ビュー クラスに そっくりです。 もっとも CWiid クラスは 
CView クラスの 基底 クラスで すから、 CView クラスに 比べて サービスが 贫强 である こと 
は明甶 です 。この 点の 違いに ついては、 後 ほど 解説し ます。 




C .3 ウインドウを 開いて、 閉じる だけの スケルトン 




図 C -3 CMainFrame クラスと CChildView クラスの 関係 



C _3 ウインドウを 開いて、 閉じる だけの スケル 卜ン 

こうして 作成され た プロジェクトを ビル ド すれば、 さらに 迫い は 鮮明になります。 

図 C -4 に 実行した NoDocView を 示します 〇 AppWizard で 生成した 丨 6: 後に ビル ドした 
だけです から、 M もで きないのは、 1 彳然 です が、 f 想 以丨 ••に M もで きません。 




図 C -4 NoDocView の 実行 画面 

図 C -4 で/〗 •くした ように、 [ファイル] メニュー (こは [アプリケーションの 終，] 以外には 
何もありません 。ドキュメント クラスがない ので [新規 作成] はありません し、 [丨 期く] や 
[保 打:] もありません 。つまり、 ファイル オープン ダイアログを |»| くこと すらで きないので 
す。 旧災] メニューには [コピー] や [切 り 取り] など 標 ，的な コマンドが ⑴盘 されて いま 
すが、 これら メニュー コマンドの ハンドラが 行: 丫丨 •: しないので グレイ 表示され る だけで 何も 
できません 。もっ とも、 ドキュメント 一 ビュー •アーキテクチャを 使った スケルトン でも、 
この 点に ついては M じでした が。 かろうじて、 [衣 示] メニューで ツール バーと ステータス 
バーの 表示 非 衣ボを 切り 持え たり、： ヘルプ] メニューから アバウト ボックスの 农示 がで 
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きる にす ぎません。 

つまり、 作成され た スケルトンは ウインドウを 表示し、 閉じる ことし かで きないの です。 

C .4 スケルトンの 内容 

このように 何もで きない スケルトンで すから、 相応に コード サイズ も 小さな ものです。 
ここでは 簡準に ドキュメント-ビュー •アーキテクチャを 使った 場合と 比較して、 上述した 
3 つの クラスに 州 盘 されて いる 主要な メンバを 解説し ます。 



• CNoDocViewApp::lnitlnstance 仮想 メンバ 関数 

CWinApp :: InitInstance 仮想 メンバ 関数は アブリ ケー シ ヨンが 実行され た 也 後に 初期 
化 処理を 行う 場所です 。ドキュメント - ビュー •アーキテクチャを 使った 坳介 は、 ここ 
で ドキュメント クラスと ビュー クラス、 そして フレーム ウインドウ クラスを 結び付け 
るた めに、 ドキュメント テンプレートが 记 在され ていました が、 もちろん この 処理は 
なくなって います。 

また、 コマンド ラインから 起勋 された ときに パラメ 一夕を 解析して、 ファイルを 開い 
たりす る 処理 も 竹 略されて います 。扱うべき ドキュメント クラスがない のです から、 
当然の 措 的と 言える でしょう 0 

• CMainFrame::m_wndView メンバ 変数 

ドキュメント 一 ビュー •アーキテクチャを 使う 場合は、 ビュー クラスは ドキュメント ク 
ラスの 竹 理ド にあった ため、 C View 才 ブジェク 卜は CDocument クラスの メンバ 変数 
として 竹理 されて いました 。それに 対して 使わない 場 介は、 メインフレーム ウィンド 
ウを竹 -PI! •する CMainFrame クラス 喂の メンバ 変数と して、 ビュー クラスに 相 出す る 
CChildView 才 フジェ ク 卜が 定 在され ています 。それが CMainI r rame::m_wndView メ 
ンバ 変数です 0 

• CMainFrame::OnCreate 仮想 メンバ 関数 

上述した CMainFrame::m_wndView メンバ 変数を 使って、 灾際に CChildView クラ 
スに対 丨え、 する ウィンドウを 作成す る简所 が CMainFrame::OnCreate 仮想 メンバ 数 
です 〇 CChild View クラスに 対応す る ウィンドウは、 メインフレーム ウィンドウの 子 
ウィンドウ として 作成され るた め、 メインフレーム ウィンドウ （親 ウィンドウ） が 作成 
された あとに 作成す る 必要が あります （親がなければ ，•は 産めません）。 そこで、 ウィ 
ン ドウが 作成され た 底 後に 呼び出される OnCreate 仮想 メンバ 問 数が 使われて います。 
この 仮想 メンバ 閲 数では ほかに も、 ツール バー オブジェクト や ステータス バーオ ブジェ 
クトの 作成が 同時に 行われ ますが、 これは ドキュメント-ビュー •アーキテクチャを 
使った 場合と 同じです。 
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• CChildView::OnPaint 仮想 メンバ 関数 

ドキュメント 一 ビュー •アーキテクチャを 使った 場合には 、丨 由丨而 衣 示は 常に CView :: On 
Draw 仮想 メンバ 関数で 処 坪して いました 。しかし ビュー クラスはありません から、 代 
枰 クラスで ある CChildView クラスの OnPaint 似 想 メンバ 間数が これに 代わって 使わ 
れ ます。 

CWnd::OnPaim 仪 想 メンバ 閲 数は \ VM_PAINT メッセージの メッセージ ハンドラと 
して あらかじめ 定義され ている 関数です 。灾は CView クラスで も CView::OnPaint 仮 
想 メンバ _ 数から CView::OnDraw 仮想 メンバ 関数を 呼び出し ている だけだった ので、 
OnDraw 仮想 メンバ 関数と OnPaint 仮想 メンバ 間数は ほぼ 同じ ものと 考える ことが 
できます 。ただし、 CView クラスでは、 丨由 iift 丨衣 示と 印刷の 丨 山】 •ノアと も CView :: OnDraw 
仮想 メンバ 閲 数で 行う という II 的が あった ため、 CView::OnPaint 仮想 メンバ 関数と 
CView::OnDraw メンバ 閲 数は 分けられて いたのです。 しかし、 印刷を サボー 卜しな 
い CChildView クラスでは 盘 味の ない f •問な ので、 め: 接 OnPaint 仮想 メンバ 閲 数に 表 
ポ 処理を 記述し ます。 
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さて、 こうして 作成され た スケルトンに r •を 加える 段階に 来たと き、 迫い は あるので しょ 
つか。 ドキュメント 一 ビュー •アーキテクチャ によって 提供され ていた 多くの サービスが 
削除され ている のです から、 仆 私が 坳 える のは もちろんで すが、 娘し いこと に 開発 说 境の 
支 梭 ツールは そのまま 利; 丨丨 できます。 ドキュメント-ビュー •アーキテクチャを 使って い 
ない とはいえ、 作成され た スケルトンが MFC を ベースと している ことは 変わりません c 
そして 開発 支 梭 ツールは MFC を 使って さえ いれば、 問題な く勋 作し ます。 したがって、 
ClassWizard を 使って メッセージ ハンドラ や 仮想 メンバ 関数の オーバーライドが 行えます c 
また リソース エデ ィタを 使って、 メニュー や ダイアログ ボックスを エディット できます し 
たがっ て、 スケルトンの 動作 さえ 把捉で きていれば、 何の 問題 もな く、 これまで どおりの 
コー デ ィングを 行えます。 

ただし、 1 つ だけ 丨! lj 題が あります 0 VisualC++ 6.0 の 初期 バージョンでは AppWizard 
に問题 が あり、 ドキュメント - ビュー •アーキテクチャを 使わずに スケルトンを 作成した 場 
介、 ClassWizard を 開いても、 丨丨 •: 常に ハンドル できる メッセージが ー览 表示され ません。 
一 れはク フス'— とに されて いる メッセ 一 ジ フィルタ （チャイルド ウィンドウ やフレ 一 
ムウ ィン ドウの ように、 クラスが 膂理 している ウィンドウの 性格に 対応して、 ハンドルで 
きる メッ セージに 制限を 加える 仆糾 み） が丨丨 常に セットアップ されない ためです。 この 問 
週を 解決す るた めには、 ClassW izard ではなく、 \\ izardBar ■から [ Windows メッセ 一 ジ 
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ハンドラの 追加] を灾 行し ます 。すると ClassWizard よりも 簡素化 された メッセージ ハン 
ドラの' 定義 ダイアログ ボックスが 表示され ます。 この ダイアログ ボックスには [クラスで 
使⑴丨 | J 能な メッセージ 州 フイ ルタ] が あり、 ここで 正常な メッセージ フイ ルタを 設定す る 
ことによって、 この 問題を 解決で きます 〇 CChildView クラスには [チャイルド ウインド 
ウ] を、 CMainFrame クラスには [トップ モー スト ウインドウ] を 指定 すれば、 その後は 
ClassWizard でも 丨丨 •: 常に メッセージ がー 览 される ようになります 0 
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春 対象 機種 および 環境 
Visual C ++ 6.0 が 動作す る 機種 および 環境 

籲 フロッピー ディスクの 内容 

本霱に 掲載され ている サンプル プログラムの ソースコード 

鲁注恿 

CD - ROM には 実行可能 ファイルは 含まれて いません。 また、 ソース 
コードの コンパイルには Visual C ++ 6.0 が 必要です。 

CD - ROM に 収められ ている ソースコードを 利用す る 前に、 ハード ディ 
スクに それらの ファイルを すべて コピーして、 読み取り 専用 属性を は 
ずす 作業が 必要です。 詳しくは 本書の 「付属 CD - R 〇 M について」 を 
参照して ください。 

CD - ROM には 、 Visual C ++ 6.0 本体は 含まれて いません。 別途 ご 
用意く ださい。 





籮1擊 Vtoual C ♦♦に _ ってみ i う 

i 幸 visiMjoidi ? 

< 2 幸 Visual 6 f + 流 プログラミング!！ 

プログラムを 解剖して みよう 
4* フレームワークを 解剖して みよう 

%m ： r * 9 f f* % • ★ ; T • • • • • *Tf 广 一 * • • • — . ' 

籣 2 部 Visual C ♦♦プログラミングの 慕 拿を If さえよう 

1 章 GDI は グラフィックス 表示の 合 首 葉 
2 章 メニューを 使って みよう 
3 章 ダイア □グ ボックスを 使って みよう 
4* マウスと キーボードからの 入力 
5 章 デバッグして みよう. 

讓 3 tt MFC を 使って みよう 

1 章 テキス 卜 エディタを 作って みよう 
2 章 ドロー ツールを 作って みよう 

第 4 部 Windows らしい アプリケーションを 嫌って みよう 

1 章 URL マネージャの 概要 
2 章プ □グラム 作成の 前 準備 
3 章ツリ ，ビュー コン 卜 ロールを 使って みよう 
4* もう 少し WWW ブラウザ らしく 



